CODEX 授权 API 对接文档

通过 HTTP 接口批量提交账号授权任务 · 返回 JSON · 任务结果可轮询查询

1. 注册 / 登录获取 API Key

注册一个账号,系统自动分配一个 API Key(一人一个,与账号绑定)。提交任务时放入 X-API-Key 请求头,CDK 在提交任务时携带,接码成功自动扣 CDK 次数。CDK 购买:https://wzyp.cn/shop/vavaix(联系客服 QQ 1586064631)。

2. 基础地址

https://tokenvavix.com/api/v1/

3. 提交任务

POST/tasks

请求头:X-API-Key: pk-你的Key,Content-Type: application/json

参数必填说明
cdk是CDK 卡密,验证剩余次数;任务成功才扣 1 次,重试不重复扣
accounts是账号列表,一行一个(格式见下)
sub2_base是你自己的 sub2 地址(如 http://xxx:8081)
sub2_key是你自己的 sub2 API Key
proxies否代理列表,一行一个,与账号按行一一对应;空则不使用
concurrency否并发数,最大 4,默认 4,超出排队

账号格式

示例

curl -X POST https://tokenvavix.com/api/v1/tasks \
  -H "X-API-Key: pk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "cdk": "cdk-10-xxxx",
    "accounts": "user1@icloud.com----pass1----TOTP1\nuser2@icloud.com----pass2----TOTP2----https://邮箱api",
    "sub2_base": "http://你的sub2:8081",
    "sub2_key": "你的sub2key",
    "proxies": "",
    "concurrency": 4
  }'

返回:{"ok":true,"submitted":2,"errors":[],"tasks":["任务ID1","任务ID2"]};errors 里是格式无法识别的行;CDK 无效 / sub2 未填会拒绝提交。

4. 查询任务

GET/tasks —— 自己的全部任务(按提交时间倒序)

curl -H "X-API-Key: pk-你的Key" https://tokenvavix.com/api/v1/tasks

GET/tasks/<任务ID> —— 单个任务详情(含阶段、进度、日志)

curl -H "X-API-Key: pk-你的Key" https://tokenvavix.com/api/v1/tasks/任务ID

任务状态:queued 排队中 / running 执行中 / success 成功 / failed 失败 / stopped 已停止。
每个任务自动执行:初始 1 次 + 失败重试 1 次(重试会重新拉取全新授权链接整流程重跑)。

5. 全站统计

GET/stats

curl -H "X-API-Key: pk-你的Key" https://tokenvavix.com/api/v1/stats

返回:今日成功、累计成功、平均耗时、近 7 日每日成功数、当前并发/排队/执行中。

重要说明
① CDK 按任务成功扣减(sub2 上传成功即成功),失败/重试不扣;
② sub2 必须使用你自己的地址和 Key,未填写拒绝提交;
③ 不同 API Key 的任务互相隔离,只能查询自己的;返回数据不包含密码 / 2FA / 代理;
④ 接码(短信平台)由平台统一提供,无需配置;短信 30 秒未收到自动释放重取,复用号码优先;
⑤ 仅在检测到 Cloudflare 挑战页时自动打码,不影响正常流程;
⑥ 单任务耗时通常 1-4 分钟,建议提交后每 10-15 秒轮询一次任务状态。