Temp Mail API 与 SDK
面向开发者的统一 REST API：创建临时邮箱地址，接收真实邮件。
Mail.td 是面向开发者的 Developer Email Platform，提供统一的 REST API，用于创建 temp mail 临时邮箱地址、接收真实邮件，并通过 WebSocket 或签名 Webhook 实时推送新邮件。API 免费即可开始使用，兼容任何 HTTP 客户端 —— 可直接在 Selenium、Cypress、Playwright、Puppeteer 测试、CI/CD 流水线或你自己的后端里调用。
工作流程
- 1
调用 POST /api/accounts，在 Mail.td 系统域名（或 Pro 的自定义域名）上创建一个 temp mail 临时邮箱地址。
- 2
把该地址用于你的测试脚本、应用或任何需要接收邮件的场景。
- 3
Mail.td 的 SMTP 服务器接收邮件，解析后存储。
- 4
轮询 GET /api/accounts/{id}/messages，或订阅 WebSocket / 注册 Webhook 进行实时接收。
- 5
调用 GET /api/accounts/{id}/messages/{messageId} 拿到完整的解析结果 —— Header、正文（纯文本 + HTML）、附件、原始 .eml。
- 6
用完可以手动删除邮箱，或让它在 7 天后自动过期。
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。
SMTP Sandbox 出站邮件测试
Mail.td 同时提供 SMTP Sandbox —— 一个虚拟的 SMTP 服务器，拦截你应用发出的所有邮件而不真正投递。把应用的 SMTP 客户端指向沙箱即可端到端测试交易邮件，通过同一套 REST API 查看主题、HTML 正文和附件。真实用户永远收不到测试邮件。