开发者

基于 TempMail API 进行构建

通过 HTTP 创建收件箱并读取验证码。无需账号即可立即开始使用,或创建 API 密钥以解锁 Pro 功能。

无需登录 · 无需 API 密钥

立即匿名开始

与驱动 TempMail 网页版相同的底层 API。每个邮箱都会分配一个随机地址,有效期为 24 小时。

  1. 1POST /accounts 用于创建带有随机地址和密码的邮箱。
  2. 2POST /token 使用地址和密码换取 tm_box_ 邮箱 Token。
  3. 3GET /messages 返回收到的邮件,并已自动提取出验证码。
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,…}
阅读完整 API 参考文档
Pro

用于解锁 Pro 功能的 API 密钥

tm_live_ API 密钥归属于您的 TempMail 账号。当您的账号处于 Pro 状态时,该密钥会自动解锁:

  • 自定义地址:携带您的密钥并在 POST /accounts 请求中附带 "address" 字段
  • 更高限额:每秒 20 次请求,每天可新建 1000 个邮箱
  • 多达 10 个永不过期的专属地址
  • 30 天邮件保留时长与 100 MB 存储空间

免费账号也可以创建密钥。在升级之前,其运作方式与匿名 API 相同,升级后无需更改任何代码。