临时邮箱 API 文档

支持多个临时邮箱服务提供商

ChatGPT Mail API

GET/generate-email

生成 ChatGPT Mail 临时邮箱地址（服务端自动从 public-key-status 拉取当日 Key）

# 请求示例

curl https://13.584136.xyz/generate-email


# 成功响应 (200)

{"success": true, "data": {"email": "example@chatgpt.org.uk"}}


# 额度耗尽 (429) — reset_at 为 UTC，+8h 即北京时间

{"success": false, "data": {"remaining_today": 0, "reset_at": "2026-04-28T00:00:00Z"}}


# 其他错误 (500)

{"success": false, "error": "生成邮箱失败"}

GET/emails?email=xxx@xxx.com

获取邮件并自动提取验证码（服务端自动从 public-key-status 拉取当日 Key）

# 请求示例

curl https://13.584136.xyz/emails?email=example@chatgpt.org.uk


# 成功响应 (200)

{"success": true, "data": {"codes": [{"code": "FB-07415", "from": "no-reply@xxx", "subject": "...", "time": "..."}]}}


# 无邮件或未提取到验证码时 codes 为空数组

{"success": true, "data": {"codes": []}}


# 缺少参数 (400)

{"success": false, "error": "邮箱地址不能为空"}


# 额度耗尽 (429)

{"success": false, "data": {"remaining_today": 0, "reset_at": "2026-04-28T00:00:00Z"}}


# 其他错误 (500)

{"success": false, "error": "获取邮件失败"}

GET/raw-emails?email=xxx@xxx.com

获取原始邮件完整内容（服务端自动从 public-key-status 拉取当日 Key）

# 请求示例

curl https://13.584136.xyz/raw-emails?email=example@chatgpt.org.uk


# 成功响应 (200) - 透传上游 data（含 emails[] 等），仅移除 usage

{"success": true, "data": {"emails": [{"from_address": "...", "subject": "...", "content": "...", "created_at": "..."}]}}


# 缺少参数 (400)

{"success": false, "error": "邮箱地址不能为空"}


# 额度耗尽 (429)

{"success": false, "data": {"remaining_today": 0, "reset_at": "2026-04-28T00:00:00Z"}}


# 其他错误 (500)

{"success": false, "error": "获取邮件失败"}

Mail.cx API

GET/api/mail-cx

生成 Mail.cx 临时邮箱地址

# 请求示例

curl https://13.584136.xyz/api/mail-cx


# 响应示例

{"email": "abc12345@qabq.com"}

GET/api/mail-cx/mail?email=xxx

获取邮件并提取验证码

# 请求示例

curl https://13.584136.xyz/api/mail-cx/mail?email=abc12345@qabq.com


# 响应示例

{"code": "320199"}

Temp-mail.io API

GET/api/temp-mail

生成 Temp-mail.io 临时邮箱地址

# 请求示例

curl https://13.584136.xyz/api/temp-mail


# 响应示例

{"email": "example@tempmail.com"}

GET/api/temp-mail/mail?email=xxx

获取邮件并提取验证码

# 请求示例

curl https://13.584136.xyz/api/temp-mail/mail?email=example@tempmail.com


# 响应示例

{"code": "123456"}

使用说明

  1. 调用生成邮箱接口获取临时邮箱地址
  2. 使用该邮箱地址进行注册或接收验证码
  3. 调用获取邮件接口，传入邮箱地址参数
  4. API 会自动从邮件内容中提取验证码
  5. 如果没有邮件或未找到验证码，返回 {"code": null}

ChatGPT Mail 共享 Key 与额度

自动获取当日 Key：/generate-email、/emails 和 /raw-emails 每次请求时会先访问 https://mail.chatgpt.org.uk/api/public-key-status， 拿到当日共享 Key 后再转发上游。Key 每天会变化，无需客户端传入。

额度限制：该共享 Key 有每日调用上限（daily_limit）。耗尽后服务返回 HTTP 429，并带上 remaining_today 和 reset_at。

reset_at 时区：UTC（尾端 Z），中国用户请 +8 小时转为北京时间 （例：2026-04-28T00:00:00Z → 北京时间 2026-04-28 08:00:00）。

响应状态码汇总：

  • 200：成功（success: true）
  • 400：缺少 email 参数（/emails、/raw-emails）
  • 429：当日额度耗尽，返回 remaining_today、reset_at
  • 500：拉取 Key 失败 / 上游调用异常 / 解析异常

注意事项

  • 临时邮箱有效期有限，建议及时获取验证码
  • 邮件可能需要几秒到几分钟才能到达
  • 验证码提取基于正则匹配，可能无法识别特殊格式
  • 不同服务商的邮箱域名和稳定性可能不同