认证方式

请求头携带 X-API-Key: <your_api_key> 当前可直接填写管理页生成的 CDKey。

接口列表

提交任务参数

完整调用流程

1. GET /api/health 检查服务状态。
2. GET /api/balance 查询 Key 余额。
3. GET /api/queue 查询队列是否空闲。
4. POST /api/jobs 提交账号并获取 job_id。
5. GET /api/jobs/{job_id} 每 3 秒轮询直到 success 或 failed。
6. 若失败且 has_offer_url=true，可用 POST /api/action 花费 0.5 额度解锁。
7. GET /api/result?email=... 可按 Email 找回结果。

curl 提交示例

curl -X POST "https://你的域名/api/jobs" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX" \
  -d '{"email":"user@gmail.com","password":"your_password","totp_secret":"JBSWY3DPEHPK3PXP"}'

JavaScript 接入示例

async function api(path, options = {}) {
  const res = await fetch('https://你的域名' + path, {
    ...options,
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'ak_XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX',
      ...(options.headers || {})
    }
  });
  if (!res.ok) throw await res.json();
  return res.json();
}

const job = await api('/api/jobs', {
  method: 'POST',
  body: JSON.stringify({
    email: 'user@gmail.com',
    password: 'your_password',
    totp_secret: 'JBSWY3DPEHPK3PXP'
  })
});

const status = await api('/api/jobs/' + job.job_id);

解锁失败暂存链接

curl -X POST "https://你的域名/api/action" \
  -H "Content-Type: application/json" \
  -d '{"action":"purchase_failed_link","cdkey":"XiXi-XXXX-XXXXX-XXXXX-XXXXX-XXXXX","task_id":123}'

状态与扣费

• 任务状态：queued、running、success、failed。
• 建议每 3 秒轮询一次任务状态，单任务按 5 分钟超时处理。
• URL 提取成功扣除 0.5 额度；失败不扣费，余额不足返回 HTTP 402。
• 失败任务若返回 has_offer_url=true，可花费 0.5 额度解锁真实链接。
• 已成功处理过的邮箱重复提交会返回 HTTP 409，并附带之前的 URL。

常见错误码

invalid_api_key、 insufficient_balance、 already_queued、 already_processed、 failed_offer_url_available、 no_offer_url、 job_not_found、 service_paused。