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 mailtdClient không phụ thuộc, dùng fetch native, với định nghĩa kiểu TypeScript đầy đủ.
Python
pip install mailtdClient dựa trên HTTP với kiểu dataclass và hỗ trợ async context manager.
Go
go get github.com/mailtd/mailtd-goChỉ dùng stdlib, vòng đời request dựa trên context, struct có kiểu đầy đủ.