临时邮箱 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。

注意事项 Pro 套餐邮件保留 7 天,到期后邮件自动删除(免费套餐保留时间见定价页面)。Mail.td 面向邮件测试、QA 自动化和开发者临时使用场景设计,不作为长期邮箱使用。