仅收件邮箱 API · 免费开箱即用
专为 Agent 与自动化测试打造的真实收件箱
仅需一次 API 调用即可快速生成一次性邮箱地址，并以 JSON 格式直接读取验证码、登录链接（Magic Link）与附件。无需配置 SMTP，告别共用邮箱与不稳定的测试账号。
无需注册 · 无需信用卡 · 无需 API 密钥
与您现有的开发工具无缝集成
- Claude Code
- Cursor
- Playwright
- Cypress
- Selenium
- Puppeteer
- n8n
- Zapier
- Python
- Node.js
适用于任何支持发送 HTTP 请求的 Agent、测试运行器或脚本。
使用场景
专为需要自动查收邮件的代码打造
支持自主注册的 AI Agent
让 Claude Code、浏览器智能体和自动化工作流自行创建邮箱、在网站完成注册并获取验证码——全程无需人工复制验证码。
真正验证邮件收发的端到端测试
为每次 Playwright 或 Cypress 测试运行分配全新的收件箱。对邮件主题、正文及链接进行断言，随后即可直接丢弃。
QA 环境中的注册与 OTP 验证流程
在不同环境中验证欢迎邮件、OTP 动态验证码及密码重置流程，无需繁琐维护 Gmail 测试账号池。
网络爬虫与自动化脚本
只需一个简单的 REST 请求，即可在脚本和无代码工作流中轻松处理邮箱验证步骤。
工作原理
只需三步，无需繁琐配置
- 01
创建邮箱
POST /accounts 会返回一个全新的随机地址和密码。无需注册账号或 API 密钥。
- 02
触发邮件发送
使用该地址进行注册、重置密码或执行测试。邮件通常在数秒内即可送达。
- 03
读取验证码
使用密码换取邮箱 Token，并以 JSON 格式拉取邮件。系统会自动为您提取验证码。
快速上手
仅需三次请求，从零开始获取验证码
复制、粘贴即可运行。这些示例使用的是匿名一次性邮箱 API，无需注册任何账号。
BASE=https://www.tempmail.ai/api/v1
# 1. Create a mailbox (random address + password)
curl -s -X POST "$BASE/accounts" \
-H "Content-Type: application/json" -d '{}'
# {"id":"…","address":"k3x9m2q7…@tempmail.ai","password":"…","expires_at":"…"}
# 2. Exchange the credentials for a mailbox token
curl -s -X POST "$BASE/token" \
-H "Content-Type: application/json" \
-d '{"address":"ADDRESS","password":"PASSWORD"}'
# {"id":"…","token":"tm_box_…","token_type":"Bearer","expires_at":"…"}
# 3. Read messages – verification codes are already extracted
curl -s "$BASE/messages" -H "Authorization: Bearer TOKEN"
# {"items":[{"from":"[email protected]","subject":"Your verification code","verification_code":"482913",…}],"total":1,…}功能特性
满足代码读取邮件所需的一切功能
自动提取验证码
系统会自动解析每封邮件中的 OTP 及各类验证码，并作为 verification_code 返回，无需自己编写正则表达式。
完整的邮件内容访问
提供每封邮件的 HTML、纯文本以及原始 RFC 822 源码。
附件
通过相同的鉴权 API 查询并下载附件。
原生私密设计
每个邮箱仅可通过其专属 Token 读取。仅凭邮箱地址绝无法获取邮件内容。
OpenAPI 3.1 规范
机器可读的规范，AI Agent、代码生成器及 HTTP 客户端均可直接接入。
可预期的速率限制
每个响应均包含速率限制响应头和请求 ID，便于代码准确获知重试时机。
安全与隐私
精心设计，杜绝未经授权的邮件访问
- 邮箱密码和 Token 仅以哈希值形式存储。丢失的 Token 任何人（包括我们）都无法反查或恢复。
- 每封邮件仅归属于单个邮箱实例——被回收复用的地址绝不会泄露历史邮件。
- 邮箱将在 24 小时后过期，您也可以随时自行删除邮箱或单封邮件。
- 仅限接收：该 API 无法用于发送、回复或转发邮件。