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
生产邮箱资产自动导入
此路线只导入可读邮箱资产到 API Key 所属用户的邮箱池，不写入 GPT 账号仓库。
POST /api/accounts/import
Authorization: Bearer mak_xxx
Content-Type: application/json
{
"text": "user@outlook.com----password----client_id----refresh_token----production-batch",
"auto_scan": false,
"limit": 20,
"concurrency": 3
}
auto_scan=false时，新增邮箱固定进入category=new、status=new。- 导入数据必须是 Outlook 邮箱资产：
email + client_id + Microsoft refresh_token；密码和 tag 可选。 - 同一 API Key 只会导入到该 Key 所属用户的邮箱池；跨用户重复邮箱会被拦截。
- 不要发送 GPT 的
id_token、access_token、chatgpt_account_id，也不要调用/api/gpt-accounts/report。
关键边界
| 项目 | 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。