Tài liệu API

Sử dụng API token để truy cập dữ liệu email. Không phân biệt user hay admin, chỉ cần token hợp lệ.

Thử nhanh API

Mở API

1. Lấy danh sách email

Truy vấn email theo địa chỉ nhận. Thêm include_body=1 để lấy nội dung HTML.

GET /api/emails?email=test@domain.com&token=TOKEN

Tham số tuỳ chọn:

  • include_body=1 - Lấy nội dung HTML email
  • limit=20 - Số lượng email (tối đa 100)

Phản hồi mẫu:

{
  "status": true,
  "message": "Lấy danh sách email thành công",
  "data": [
    {
      "uid": "abc-123",
      "subject": "Mã xác minh của bạn",
      "from_field": "noreply@service.com",
      "date": "2026-02-13 10:30:00",
      "status": "unseen",
      "code": "123456",
      "link": ["https://verify.example.com/..."],
      "html_content": "<html>..."
    }
  ]
}

2. Lấy danh sách tên miền

Danh sách tên miền khả dụng trong hệ thống (chỉ tên miền có MX hợp lệ).

GET /api/domains?token=TOKEN

3. Kiểm tra MX Record

Kiểm tra xem tên miền có bản ghi MX trỏ về server không (không cần token).

GET /api/check-mx?domain=example.com

Cách sử dụng

Bước 1: Đăng nhập vào hệ thống để lấy API Token.

Bước 2: Gọi API với tham số token=API_TOKEN trong URL.

Bước 3: Parse JSON response để lấy dữ liệu email.

Ví dụ với cURL:

curl "/api/emails?email=user@domain.com&token=YOUR_TOKEN&include_body=1"