GPTMail 临时邮箱 API 快速上手:Key、收信、限流与子域名
用 GPTMail API 可以生成临时地址、查询收件箱、读取或删除邮件。本文提供当前接入流程与常见陷阱,完整接口参数统一链接到官方文档。
内容核对:2026 年 11 月 15 日。原始发布日期保留;动态价格、额度和可用范围请以链接中的现行说明为准。

接入前准备
API 基础地址为 https://mail.chatgpt.org.uk,请求头使用 X-API-Key。从GPTMail 最新 API 文档获取当天公共测试 Key,或登录管理自己的个人 Key 和积分。不要再使用旧文章中的固定测试 Key 或已停止服务的商店入口。
最小请求示例
下面只展示地址生成,不会发邮件、注册第三方账号或修改现有收件箱。请把密钥放在环境变量中:
curl --fail-with-body -H "X-API-Key: $GPTMAIL_API_KEY" "https://mail.chatgpt.org.uk/api/generate-email"
得到完整邮箱地址后,在你自己的测试流程中向它发送邮件,再查询收件箱。不要把示例域名 example.com 当作实际可收信域名。
常用接口
| 用途 | 方法与路径 | 注意 |
|---|---|---|
| 生成地址 | GET / POST /api/generate-email | 域名与前缀参数见官方文档 |
| 查询收件箱 | GET /api/emails?email=完整地址 | 对地址进行 URL 编码 |
| 读取一封邮件 | GET /api/email/{id}?email=完整地址 | 同时传邮件 ID 与对应地址 |
| 删除一封邮件 | DELETE /api/email/{id}?email=完整地址 | 不可把读取与删除混为一谈 |
| 清空收件箱 | DELETE /api/emails/clear?email=完整地址 | 可能分批处理;检查 has_more |
| 公开域名目录 | GET /api/domains/public | 据此选择当前有效后缀 |
| 统计 | GET /api/stats | 以文档中的字段和权限为准 |
子域名怎么用?
公开域名目录会列出可用子域名。支持 wildcard 的项目可使用允许的一层前缀;不支持通配时,从返回的 children 中选取。邮箱用户名是 @ 前的部分,不是子域名前缀。私有域名和登录专享域名不通过公开 API Key 开放。
稳定调用的四个检查
- 先检查 HTTP 状态码及 Content-Type,再解析 JSON;代理或平台错误可能返回 HTML。
- 生成地址的 GET/POST 共用来源 IP 速率限制:当前为每 10 秒 30 次。出现 429 时遵循 Retry-After,并使用退避。
- 不要为每次收信轮询重新生成邮箱;保留完整地址,适度轮询,避免占用共享资源。
- 清空接口是破坏性操作;has_more 为 true 时表示仍有待处理批次,不能把一次响应当成全部删除完成。
安全与保存期限
公开临时收件箱不适合敏感信息、金融账号、密码找回和长期通信;邮件最多保留 24 小时。已知可用域名下的邮箱地址可以按有效用户名组合,但这不代表有账号所有权或隐私保证。
本文不再复制整份接口参考,以免返回字段更新后产生两套互相矛盾的文档。请求体、响应示例、错误码与实时规则请查看GPTMail 最新 API 文档;密钥获取方式另见API Key 与积分指南。
评论与讨论
已有 9 条评论