对接 API 文档

用程序提交账号、查询进度和结果,规则与网页完全一致。

基本说明

频率限制(按 IP):提交每分钟最多 60 次请求(一次请求可带多个账号);查询每分钟最多 300 次。建议每 30–60 秒查一次,不要每个任务单独高频轮询,用「任务列表」一次查完。
API Key 连续填错 10 次,该 IP 会被暂停 10 分钟;持续违规会被封禁。

GET /api/v1/balance 查余量

{
  "ok": true,
  "remaining": 37,          // 剩余次数
  "max_uses": 100,          // 总次数
  "status": "used",         // unused / used 正常;disabled 已禁用;locked 已锁定
  "tasks": {"total": 63, "pending": 2, "running": 1, "success": 55, "failed": 5},
  "queue": {"pending": 12, "running": 4}   // 全站排队 / 处理中数量
}

POST /api/v1/tasks 提交账号

请求

{
  "accounts": [
    {"email": "abc@gmail.com", "password": "密码", "twofa": "2FA密钥或8位备用码"},
    {"email": "def@gmail.com", "password": "密码", "twofa": "JBSWY3DPEHPK3PXP...", "recovery_email": "可不填"}
  ]
}

返回

{
  "ok": true,
  "count": 2,                                   // 实际提交了几个
  "created": [{"task_id": 1201, "email": "abc@gmail.com"},
              {"task_id": 1202, "email": "def@gmail.com"}],
  "skipped": [{"email": "xyz@gmail.com", "reason": "该账号正在处理中"}],
  "remaining": 35
}

请保存 task_id,用它查询结果。

GET /api/v1/tasks/{task_id} 查单个任务

{
  "ok": true,
  "id": 1201,
  "email": "abc@gmail.com",
  "status": "running",       // 见下方「任务状态」
  "stage": "subscribe",      // 仅 running 时有:处理到哪一步
  "started_at": 1794728000,  // 开始处理的时间
  "queue_position": null,    // 仅 pending 时有:排第几位
  "eta_min": null,           // 仅 pending 时有:预计多少分钟后开始(估不出时为 null)
  "message": "",             // 结果说明;失败时是失败原因
  "link": "",                // 成功后若有优惠链接会在这里
  "retryable": false,        // 失败后原样重新提交是否有意义
  "created_at": 1794727000,
  "updated_at": 1794728100
}

GET /api/v1/tasks 任务列表

参数说明
status可选。pending / running / success / failed,或 active(排队中 + 处理中)
email可选。按邮箱精确查
limit每页条数,默认 100,最大 500
offset从第几条开始,默认 0
{"ok": true, "total": 63, "offset": 0, "items": [ {…同「查单个任务」的字段…} ]}

新任务排在前面。

任务状态

status含义
pending排队中
running处理中
success已完成(最终状态)
failed未通过(最终状态),次数已退回,原因见 message

处理阶段 stage(仅 running)

stage含义
start已开始处理
login正在登录
captcha正在过人机验证
check正在查询订阅资格
subscribe正在订阅
finish即将成功

错误返回

出错时 HTTP 状态码不是 200,内容为 {"detail": "错误说明"}。

状态码含义
400参数或账号格式不对
401没带 API Key,或 API Key 无效
403卡密已被禁用 / 锁定,或 IP 被封禁
404任务不存在(或不属于你的卡密)
409次数不够,或提交的账号都在处理中
413请求内容太大(单次不超过 1MB)
429请求太频繁,稍后再试

示例

curl


    

Python