临时邮箱 API
面向开发者的统一 REST API:创建临时邮箱地址,接收真实邮件。
Mail.td 是面向开发人员的电子邮件基础设施,提供统一的 REST API,用于创建 temporary email 临时邮箱地址、接收真实邮件,并通过 WebSocket 或签名 Webhook 实时推送新邮件。API 免费即可开始使用,兼容任何 HTTP 客户端 —— 可直接在 Selenium、Cypress、Playwright、Puppeteer 测试、CI/CD 流水线或你自己的后端里调用。
工作流程
创建邮箱,通过 SMTP 接收真实邮件,并通过 REST API 读取消息。邮箱 7 天后自动过期。
# 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 与客户端库
Mail.td 提供三种语言的官方 SDK,每个客户端都完整覆盖 REST API,并带类型化的响应和错误处理 —— 安装、用你的 Pro API Token 鉴权,就可以开始用了。
Node.js / TypeScript
npm install mailtd零依赖客户端,使用原生 fetch,自带完整的 TypeScript 类型定义。
Python
pip install mailtd基于 HTTP 的客户端,带 dataclass 类型和 async 上下文管理器支持。
Go
go get github.com/mailtd/mailtd-go仅依赖标准库,基于 context 管理请求生命周期,完整的 typed struct。