Tài liệu chính thức cho client tích hợp Temp Mail API. Chỉ bao gồm các endpoint public và an toàn để sử dụng trong production.
Temp Mail API cung cấp các chức năng cốt lõi:
Tất cả response đều ở định dạng JSON và sử dụng HTTP status code chuẩn.
/api/email/{recipient}
Trả về danh sách email hiện có của một địa chỉ cụ thể.
GET /api/email/demo@example.com
[
{
"id": "uuid",
"subject": "Welcome",
"fromAddress": "no-reply@service.com",
"toAddress": "demo@example.com",
"createdAt": 1700000000,
"readAt": null
}
]
createdAt và readAt là Unix timestamp (giây).
/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>"
}
body có thể chứa HTML.
/api/domains
Trả về danh sách domain được hỗ trợ để tạo email tạm thời.
[
"@example.com",
"@mail.example"
]
/api/health
Endpoint kiểm tra trạng thái hoạt động của hệ thống.
{
"status": "ok"
}