API Documentation — Temp Mail

Tài liệu API công khai dành cho client. Chỉ bao gồm các endpoint an toàn và cần thiết để sử dụng dịch vụ.

Tổng quan

Temp Mail API cho phép:

Nhận danh sách email theo địa chỉ tạm thời
Xem nội dung chi tiết của một email
Lấy danh sách domain được hỗ trợ
Kiểm tra trạng thái dịch vụ

Endpoints

GET /api/email/{recipient}

Lấy danh sách email hiện có của một địa chỉ email tạm thời.

GET /api/email/demo@example.com

[
  {
    "id": "uuid",
    "subject": "Welcome",
    "fromAddress": "no-reply@service.com",
    "toAddress": "demo@example.com",
    "createdAt": 1700000000,
    "readAt": null
  }
]

GET /api/inbox/{email_id}

Lấy nội dung chi tiết của một email theo ID.

GET /api/inbox/uuid

{
  "id": "uuid",
  "subject": "Welcome",
  "fromAddress": "no-reply@service.com",
  "toAddress": "demo@example.com",
  "createdAt": 1700000000,
  "readAt": 1700000010,
  "body": "<p>Email content</p>"
}

GET /api/domains

Trả về danh sách domain hiện được hỗ trợ để tạo email.

[
  "@example.com",
  "@mail.example"
]

GET /api/health

Kiểm tra trạng thái hoạt động của hệ thống.

{
  "status": "ok"
}

Bảo mật

Chỉ sử dụng các endpoint được công bố trong tài liệu này
Không có API ghi dữ liệu hoặc thay đổi cấu hình được public
Các endpoint nội bộ và quản trị không được hỗ trợ cho client