Temp Mail API — Public Documentation

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.

Tổng quan

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 Endpoints

GET /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).

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>"
}

body có thể chứa HTML.

GET /api/domains

Trả về danh sách domain được hỗ trợ để tạo email tạm thời.

[
  "@example.com",
  "@mail.example"
]
GET /api/health

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

{
  "status": "ok"
}

Security & Usage Policy

© 2026 Temp Mail — Public API Documentation