API Email Tạm Thời

REST API thống nhất cho nhà phát triển: tạo địa chỉ temp mail, nhận email thật.

Mail.td là hạ tầng email cho nhà phát triển, với REST API thống nhất để tạo địa chỉ temporary email, nhận email thật và gửi tin nhắn mới theo thời gian thực qua WebSocket hoặc Webhook có chữ ký. API miễn phí để bắt đầu — tương thích với mọi HTTP client. Gọi trực tiếp từ test Selenium, Cypress, Playwright, Puppeteer, pipeline CI/CD hoặc backend của bạn.

Quy trình

Tạo hộp thư, nhận email thật qua SMTP và đọc tin nhắn qua REST API. Hộp thư tự động hết hạn sau 7 ngày.

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK & Thư viện client

Mail.td cung cấp SDK chính thức trong ba ngôn ngữ. Mỗi client bao phủ đầy đủ REST API với phản hồi có kiểu và xử lý lỗi — cài đặt, xác thực bằng Pro API Token và bắt đầu dùng.

Node.js / TypeScript

npm install mailtd

Client không phụ thuộc, dùng fetch native, với định nghĩa kiểu TypeScript đầy đủ.

Python

pip install mailtd

Client dựa trên HTTP với kiểu dataclass và hỗ trợ async context manager.

Go

go get github.com/mailtd/mailtd-go

Chỉ dùng stdlib, vòng đời request dựa trên context, struct có kiểu đầy đủ.

Lưu ý quan trọng Email trên gói Pro được lưu giữ trong 7 ngày, sau đó tự động xóa (xem trang giá để biết thời gian lưu giữ của gói miễn phí). Mail.td được thiết kế cho kiểm thử email, tự động hóa QA và sử dụng tạm thời cho nhà phát triển — không phải hộp thư dài hạn.