TEMPMAIL API · V1 · MULTI-DOMAIN

Mailbox tạm & Đa domain.
REST API mạnh mẽ.

Tạo một địa chỉ email tạm thời, chọn bất kỳ domain cộng đồng nào, nhận thư, lấy OTP và kiểm tra DNS bằng REST API chuẩn.

Xem ví dụOpenAPI JSON ↗
Đang kiểm tra dịch vụ…
Base URL
—
Mail Server MX
—
Tổng số Domain
—
Mailbox TTL
—

01 · BẮT ĐẦU NHANH

Tạo mailbox trong một request.

Phản hồi của v1 luôn bọc dữ liệu trong data. Bạn có thể chỉ định prefix và domain mong muốn.

THỬ TRỰC TIẾP

Tạo mailbox mẫu

Để trống nếu muốn hệ thống sinh ngẫu nhiên.
// Kết quả sẽ xuất hiện ở đây
POST /api/v1/mailboxes
curl -X POST https://your-domain.com/api/v1/mailboxes \
  -H "Content-Type: application/json" \
  -d '{"prefix":"demo-box","domain":"mail.otkho.dev"}'
201Created
{
  "data": {
    "email": "demo-box@mail.otkho.dev",
    "prefix": "demo-box",
    "domain": "mail.otkho.dev",
    "inboxUrl": "/api/v1/mailboxes/demo-box%40mail.otkho.dev/messages"
  }
}

02 · DOMAINS & ĐÓNG GÓP

Lấy danh sách và Đóng góp Domain mới.

Bất kỳ ai cũng có thể đóng góp domain vào hệ thống.
GET/api/v1/domains
200 OK
Lấy danh sách domain khả dụng
curl https://your-domain.com/api/v1/domains
POST/api/v1/domains
201 Created
Đóng góp domain mới
curl -X POST https://your-domain.com/api/v1/domains \
  -H "Content-Type: application/json" \
  -d '{"domain":"mycustomdomain.com","contributor":"OTKHO Fan","note":"Domain hỗ trợ cộng đồng"}'
POST/api/v1/domains/verify
200 OK
Kiểm tra trạng thái DNS MX
curl -X POST https://your-domain.com/api/v1/domains/verify \
  -H "Content-Type: application/json" \
  -d '{"domain":"mycustomdomain.com"}'

03 · MAILBOX

Đọc danh sách thư.

Thư mới nhất nằm ở đầu mảng messages.
GET/api/v1/mailboxes/{email}/messages
200 OK
Ví dụ
curl https://your-domain.com/api/v1/mailboxes/demo-box%40mail.otkho.dev/messages
emailpath · bắt buộc

Địa chỉ mailbox thuộc bất kỳ domain nào trong hệ thống.

04 · MESSAGES

Lấy trọn nội dung một thư.

Dùng id từ danh sách mailbox để đọc bản text và HTML.
GET/api/v1/messages/{id}
200 OK
200OK
{
  "data": {
    "id": "f813…",
    "from": "Service <no-reply@example.com>",
    "to": "demo-box@mail.otkho.dev",
    "subject": "Your verification code",
    "bodyText": "Your code is 123456",
    "bodyHtml": "<p>Your code is 123456</p>",
    "date": "2026-07-29T10:00:00.000Z"
  }
}

05 · XÁC MINH OTP

Lấy OTP và link mới nhất.

Hữu ích cho luồng test tự động. Không tìm thấy kết quả vẫn trả 200 với mảng rỗng.
POST/api/v1/verification
200 OK
Request body
{
  "email": "demo-box@mail.otkho.dev"
}

06 · QUY ƯỚC & MÃ LỖI

Phản hồi có thể dự đoán.

400

invalid_mailbox

Email không thuộc domain TempMail hiện có trong hệ thống.

422

invalid_prefix / invalid_domain

Tên prefix hoặc định dạng domain không hợp lệ.

404

message_not_found

Thư không tồn tại hoặc đã tự hủy sau TTL.

Các endpoint cũ /api/email/* và /api/domains/* vẫn hoạt động để đảm bảo tương thích ngược.