Tài Liệu & Cổng Kiểm Thử API Đọc Thư Gmail

⚡ Trình Kiểm Thử API Trực Tiếp (Interactive Tester)

Thử nghiệm gửi yêu cầu và nhận kết quả đọc thư từ ứng dụng ngay trên trình duyệt web:

1. Lấy danh sách Email hiện có (/api/getemaillist)

Gọi API lấy toàn bộ các tài khoản Gmail đã đăng nhập trong ứng dụng.

Chưa thực thi

// Kết quả JSON sẽ hiển thị ở đây...

2. Đọc thư từ một Email (/api/getemail)

Chọn email (từ danh sách) hoặc nhập:

Hoặc nhập email trực tiếp:

Số thư mới nhất cần lấy (Limit: 1 - 50):

Chưa thực thi

// Kết quả JSON đọc thư sẽ hiển thị ở đây...

3. Mail Parser - Bóc Tách Dữ Liệu Tự Động (/api/parsers & /api/parse)

Mọi email khi đọc qua /api/getemail sẽ tự động đính kèm dữ liệu trích xuất (OTP, Link, Đơn hàng) nếu khớp với các Parser đã cấu hình trong app.

Sẵn sàng

// Kết quả danh sách Parser hoặc bóc tách sẽ hiển thị tại đây...

📖 Danh Mục & Đặc Tả Chi Tiết Các Endpoint

Chi tiết cách tích hợp vào các dự án phần mềm và ngôn ngữ lập trình:

GET /api/getemaillist

Lấy danh sách tất cả các tài khoản Gmail hiện đang được cấu hình và sẵn sàng đọc trong ứng dụng desktop.

Tham số	Kiểu	Bắt buộc	Mô tả
Không có tham số yêu cầu. Header Authorization không cần thiết.

curl http://localhost:8088/api/getemaillist

import requests

res = requests.get("http://localhost:8088/api/getemaillist")
emails = res.json()
print("Danh sách email:", emails)

fetch("http://localhost:8088/api/getemaillist")
  .then(res => res.json())
  .then(data => console.log("Danh sách email:", data));

<?php
$json = file_get_contents("http://localhost:8088/api/getemaillist");
$emails = json_decode($json, true);
print_r($emails);
?>

resp, err := http.Get("http://localhost:8088/api/getemaillist")
if err == nil {
    defer resp.Body.Close()
    var emails []string
    json.NewDecoder(resp.Body).Decode(&emails)
    fmt.Println("Emails:", emails)
}

POST GET /api/getemail

Kết nối trực tiếp tới máy chủ IMAP của Google và đọc các thư mới nhất từ hộp thư đến (INBOX) của địa chỉ email được truyền vào.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
email	Body JSON hoặc Query	string	Bắt buộc	Địa chỉ Gmail cần đọc thư (chấp nhận cả alias `data`)
limit	Body JSON hoặc Query	integer	Tuỳ chọn	Số lượng thư mới nhất cần lấy (Mặc định: 5, Tối đa: 50)

curl -X POST http://localhost:8088/api/getemail \
  -H "Content-Type: application/json" \
  -d '{"email": "user@gmail.com", "limit": 5}'

curl "http://localhost:8088/api/getemail?email=user@gmail.com&limit=5"

import requests

payload = {"email": "user@gmail.com", "limit": 5}
res = requests.post("http://localhost:8088/api/getemail", json=payload)
emails = res.json()

for mail in emails:
    print(f"[{mail['date']}] {mail['from']} -> {mail['subject']}")
    print("Nội dung:", mail['body_snippet'][:100], "...\n")

const res = await fetch("http://localhost:8088/api/getemail", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "user@gmail.com", limit: 5 })
});
const emails = await res.json();
console.log(emails);

<?php
$ch = curl_init("http://localhost:8088/api/getemail");
$data = json_encode(["email" => "user@gmail.com", "limit" => 5]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$emails = json_decode($response, true);
print_r($emails);
?>

GET /api/status

Kiểm tra tình trạng hoạt động của Gateway, số lượng tài khoản kết nối, IP Tailscale và Public URL.

curl http://localhost:8088/api/status

GET /api/parsers

Lấy danh sách các bộ Mail Parser đang kích hoạt trong ứng dụng (kèm toàn bộ danh sách quy tắc trích xuất).

curl http://localhost:8088/api/parsers

POST /api/parse

Bóc tách văn bản thô theo toàn bộ các quy tắc Mail Parser đã cấu hình trong ứng dụng.

curl -X POST http://localhost:8088/api/parse \
  -H "Content-Type: application/json" \
  -d '{"text": "Mã xác thực của bạn là: 894102. Hết hạn trong 5 phút."}'

Tài Liệu Hướng Dẫn & Kiểm Thử API