API 文档入口

GPT/OpenAI 旧注册路线和多平台复用路线已拆开，接入时不要混用。

返回控制台

先选路线

GPT/OpenAI 注册路线

最开始的 GPT 注册机链路。用 safe/new 邮箱池，领取后读验证码，并可上报 GPT 账号仓库。

  • 领取邮箱：POST /api/mailboxes/reserve
  • 读验证码：GET /api/mail/code
  • 收不到码隔离：POST /api/mailboxes/report-code
  • GPT 账号上报：POST /api/gpt-accounts/report

打开 GPT 路线文档 GPT spec

多平台复用路线

Cursor/Claude/Poe 等非 OpenAI 平台使用。必须显式传 platform，通过 lease_token 防串号。

  • 平台列表：GET /api/reuse/v1/platforms
  • 状态汇总：GET /api/reuse/v1/summary
  • 按平台预留：POST /api/reuse/v1/mail/reserve
  • 确认/释放：mark-used / release

打开多平台文档 多平台 spec

关键边界

项目GPT/OpenAI 路线多平台路线
主要用途OpenAI/GPT 注册机领邮箱和读码Cursor/Claude/Poe 等平台复用已有健康邮箱
领取接口/api/mailboxes/reserve/api/reuse/v1/mail/reserve
平台参数不需要 platform必须显式传 platform
状态语义accounts.used 是 GPT 旧链路已用mailbox_platform_usages 记录各平台使用历史
防重复领取时直接把邮箱移出 safe 池同平台 reserved/success 不再重复发
禁止事项不要接 /api/reuse/v1/*不要用 GET /api/mailboxes 分配邮箱

兼容保留：/api-spec.json 仍是合并规格，给旧工具兼容用；新接入建议直接使用上面的两份独立 spec。