开放 API
通过简单的 HTTP 接口创建临时邮箱并读取邮件,适合自动化测试、注册流程验证等场景。所有接口返回 JSON。
鉴权
调用「创建邮箱」接口会返回 token,之后的请求在请求头中携带:
Authorization: Bearer <token>
频率限制
未携带 API Key 时,每个 IP 每分钟最多创建 10 个邮箱。需要更高额度,可在创建邮箱时携带 API Key:
X-API-Key: tm_xxxxxxxxxxxxxxxx
接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /api/domains | 可用域名列表 |
| POST | /api/mailbox | 创建邮箱。body 为空则随机生成,或传 {"local":"abc","domain":"…"} 指定地址 |
| GET | /api/mailbox | 当前邮箱信息 |
| DELETE | /api/mailbox | 删除邮箱及其全部邮件 |
| GET | /api/messages | 收件箱列表(最新 100 封) |
| GET | /api/messages/{id} | 邮件详情(含正文和附件列表) |
| DELETE | /api/messages/{id} | 删除邮件 |
| GET | /api/messages/{id}/raw | 下载 .eml 原文 |
| GET | /api/attachments/{id} | 下载附件 |
| GET | /api/events | SSE 实时事件流,新邮件到达时推送 event: mail |
示例
# 1. 创建邮箱。body 为空则随机生成,或传 {"local":"abc","domain":"…"} 指定地址
curl -s -X POST https://www.temp-mail.cc/api/mailbox \
-H 'Content-Type: application/json' -d '{}'
# => {"address":"[email protected]","token":"…","expires_at":"…"}
# 2. 收件箱列表(最新 100 封)
curl -s https://www.temp-mail.cc/api/messages \
-H 'Authorization: Bearer <token>'
# 3. 邮件详情(含正文和附件列表)
curl -s https://www.temp-mail.cc/api/messages/123 \
-H 'Authorization: Bearer <token>'
# Python
import requests, time
base = "https://www.temp-mail.cc"
mb = requests.post(f"{base}/api/mailbox", json={}).json()
headers = {"Authorization": f"Bearer {mb['token']}"}
print(mb["address"])
while True:
msgs = requests.get(f"{base}/api/messages", headers=headers).json()["messages"]
if msgs:
print(requests.get(f"{base}/api/messages/{msgs[0]['id']}", headers=headers).json()["text"])
break
time.sleep(3)
错误格式
出错时返回非 2xx 状态码,响应体为:
{"error": "rate_limited", "message": "…"}