Tài liệu API

API công khai, không cần token hay xác thực. Gọi trực tiếp từ bất kỳ ứng dụng nào.

✓

API miễn phí - Không cần xác thực

Tất cả endpoint đều public, gọi thẳng không cần đăng nhập hay token.

Thử nhanh API

Mở API

/api/emails?email=test%40btgaming.ca

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

Tham số:

  • email *bắt buộc - Địa chỉ email cần xem
  • 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.

GET /api/domains

Phản hồi mẫu:

{
  "domains": ["btgaming.ca", "example.com"]
}

3. Kiểm tra MX Record

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

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

Ví dụ sử dụng

cURL:

curl "/api/emails?email=user@btgaming.ca&include_body=1"

JavaScript (fetch):

const res = await fetch('/api/emails?email=user@btgaming.ca');
const data = await res.json();
console.log(data.data); // danh sách email

Python:

import requests
r = requests.get('/api/emails', params={'email': 'user@btgaming.ca'})
emails = r.json()['data']