鉴权与响应规则

使用您自己的本地卡密。支持三种鉴权方式，选择一种即可：请求头 Authorization: Bearer <卡密>、请求头 X-CDKey: <卡密>，或 JSON 字段 cdkey。同时传入时按上述顺序优先取值。以下示例使用 JSON 鉴权。

HTTP 200 仍可能包含业务失败，必须检查 success 和 message。HTTP 400 表示请求格式、参数或 action 错误，401 表示卡密无效，404 表示任务不存在或不属于该卡密，410 表示功能已停用。其他 HTTP 错误也应处理。

{
  "success": false,
  "message": "无效的授权卡密"
}

1. 查询余额与统计

action: get_balance，别名 stats。余额和统计均来自本地系统；统计查询不会主动同步所有上游任务。

请求：

{
  "action": "get_balance",
  "cdkey": "YOUR_CDKEY"
}

响应示例；pending 统计包含待确认任务，pending_queue_cost 为这些排队及待确认任务的额度合计：

{
  "success": true,
  "remaining_uses": 10.5,
  "pending_queue_cost": 1.5,
  "status_counts": {
    "pending": 1,
    "running": 0,
    "success": 2,
    "failed": 0
  }
}

2. 提交订阅任务

action: submit_task，别名 submit。email、password、twofa 均为必填字符串；twofa 支持别名 totp，支持 2FA 密钥或 8 位备用码；多个备用码用 / 分隔，例如 01234567/87654321。请使用字符串保留开头的 0。recovery_email 为可选辅助邮箱。

单号与批量提交均使用上述套餐：6月（1额度）、12月（1.5额度）、24月（2额度）。批量总额度 = 账号数量 × 每条额度，例如 10 条 12月套餐需要 15 额度。修改下面示例中的 task_type 即可切换期限；省略时默认 sub6。

task_type 支持别名 task_mode。旧值 full 按 sub6 处理；extract 已停用。示例中的账号和卡密均为占位值。

单账号请求：

{
  "action": "submit_task",
  "cdkey": "YOUR_CDKEY",
  "task_type": "sub12",
  "email": "example@gmail.com",
  "password": "ACCOUNT_PASSWORD",
  "twofa": "TOTP_SECRET",
  "recovery_email": "backup@example.com"
}

已确认受理的响应示例（其余字段 results、index、email 为单账号响应附加信息）：

{
  "success": true,
  "message": "排队中",
  "task_id": 1024,
  "status": "Pending",
  "uncertain": false,
  "pending_confirmation": false,
  "task_type": "sub12",
  "cost_per_item": 1.5,
  "remaining_uses": 9.0,
  "submitted_count": 1,
  "results": [
    {
      "index": 0,
      "email": "example@gmail.com",
      "success": true,
      "message": "排队中",
      "task_id": 1024,
      "status": "Pending",
      "uncertain": false,
      "pending_confirmation": false,
      "task_type": "sub12",
      "cost_per_item": 1.5,
      "remaining_uses": 9.0
    }
  ]
}

3. 批量提交

使用同一提交 action，顶层 task_type 统一指定整批套餐；不要在每条账号中指定不同套餐。每批最多 100 条。可选 tasks 非空数组或 account_data 多行文本；同时提供时优先使用 tasks。

{
  "action": "submit",
  "cdkey": "YOUR_CDKEY",
  "task_type": "sub6",
  "tasks": [
    {
      "email": "example@gmail.com",
      "password": "ACCOUNT_PASSWORD",
      "totp": "TOTP_SECRET"
    }
  ]
}

多行文本格式为“邮箱----密码----2FA----辅助邮箱”，辅助邮箱可省略：

{
  "action": "submit",
  "cdkey": "YOUR_CDKEY",
  "task_type": "sub6",
  "account_data": "first@gmail.com----PASSWORD----TOTP_SECRET\nsecond@gmail.com----PASSWORD----TOTP_SECRET----backup@example.com"
}

响应包含 results 数组，每项带从 0 开始的 index、email 及该条业务结果。submitted_count 统计 success 为 true 的条数；pending_confirmation_count 统计待确认条数。两者可能重叠：受理成功但尚未核实任务 ID 的条目也需待确认。顶层 success 仅在全部条目 success 为 true 时为 true，不代表所有任务已完成或均已确认 ID。部分失败时已受理条目仍有效，不要整批重发。账号格式校验不通过时整批返回 400，尚未开始提交。

4. 待确认、计费与重试

提交前预扣套餐额度。提交超时、响应不明确或已受理但无法核实上游 ID 时，任务保留 Submitting，返回 pending_confirmation: true、uncertain: true；此时 success 可能为 true 或 false。保留返回的本地 task_id，查询状态并联系管理员核对，切勿因超时或 success 为 false 就自动重发。同一邮箱存在进行中或待确认任务时会阻止重复提交。

明确拒绝受理时退回预扣额度；执行失败是否退款以状态接口的 refunded 为准。上游明确不退款或“物理限飞”等情况不会退款。查询失败本身不会触发退款，业务执行状态 Failed 不保证已经退款。

5. 查询单个任务状态

action: get_status，别名 detail。传入本地 task_id（整数）或 email，至少一个；同时传入时优先 task_id。邮箱查询返回该卡密下该邮箱最新一条记录。所有接口中的任务 ID 均为本地 ID。

{
  "action": "get_status",
  "cdkey": "YOUR_CDKEY",
  "task_id": 1024
}

响应示例：

{
  "success": true,
  "data": {
    "id": 1024,
    "task_id": 1024,
    "email": "example@gmail.com",
    "status": "Pending",
    "message": "排队中",
    "task_type": "sub12",
    "cost_per_item": 1.5,
    "package_type": "sub12",
    "cost": 1.5,
    "sub_expiry": "",
    "completed_at": "",
    "submission_state": "confirmed",
    "refunded": false
  }
}

主要状态：Submitting 待确认、Pending 排队中、Running 执行中、Success 成功、Failed 失败或已取消。submission_state 为提交确认信息，可能为 accepted、uncertain、confirmed、rejected；历史任务可能为空。sub_expiry 为订阅到期信息，未取得时为空；completed_at 未取得时为空。

查询会尝试同步上游；同步失败时可能仍返回本地已有状态，success 为 true 不保证上游刚刚刷新成功。当前接口不返回 offer_url 或 has_offer_url。

6. 分页查询任务列表

action: list。page 默认 1，最小 1；limit 默认 50，范围 1–100。传整数，超出范围会调整。按本地任务 ID 倒序返回，仅包含本卡密的任务。分页时不要传 task_id 或 email，否则会切换为单任务查询。

{
  "action": "list",
  "cdkey": "YOUR_CDKEY",
  "page": 1,
  "limit": 50
}

data 为任务对象数组，字段与单任务 data 相同。空列表响应示例：

{
  "success": true,
  "data": [],
  "page": 1,
  "limit": 50,
  "total": 0
}

7. 取消排队任务

action: cancel_task，别名 cancel。必填本地 task_id。仅已确认上游 ID 的 Pending 任务可取消；上游确认取消后退回原任务额度。取消结果待确认时先查询状态，不要直接认定已退款。取消后的本地状态为 Failed，message 说明主动取消。

{
  "action": "cancel_task",
  "cdkey": "YOUR_CDKEY",
  "task_id": 1024
}

成功响应示例：

{
  "success": true,
  "message": "任务已取消，对应额度已退回",
  "remaining_uses": 10.5
}

8. 任务完成回调

提交时可在请求顶层增加 callback_url（公网 HTTPS、443 端口）及 callback_secret（16–256 字符随机密钥）。批量任务共用该配置，重试沿用原配置。任务成功、失败或确认取消后 POST 通知；待确认状态不发送完成通知。

"callback_url": "https://your-domain.com/completed",
"callback_secret": "YOUR_RANDOM_SECRET_16_CHARS_OR_MORE"

请求头包含 X-Webhook-Id、X-Webhook-Timestamp 与 X-Webhook-Signature。签名为 sha256= + HMAC-SHA256 十六进制值，使用 callback_secret 对 时间戳 + "." + 原始请求体 签名。验证时间戳偏差不超过 5 分钟，按事件 ID 去重，可靠保存后返回 2xx。

{"event":"task.completed","task_id":1024,"generation":1,"email":"user@example.com","status":"Success","message":"订阅成功","task_type":"sub6","refunded":0,"sub_expiry":"","completed_at":""}

通知不包含账号密码、2FA 或卡密。失败投递自动退避重试，累计最多 8 次；可能重复，请务必去重。回调失败不影响任务和余额。

已停用功能

仅提取链接套餐 extract 已停用。action: purchase_failed_link 返回 HTTP 410 和 success: false，请勿继续调用。