API 接入指南

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

{
  "success": true,
  "remaining_uses": 10.0
}

{
  "action": "submit_task",
  "cdkey": "YOUR_CDK",
  "email": "YOUR_GOOGLE_EMAIL",
  "password": "YOUR_GOOGLE_PASSWORD",
  "twofa": "YOUR_TOTP_SECRET",
  "task_type": "full"
}

{
  "action": "submit_task",
  "cdkey": "YOUR_CDK",
  "email": "YOUR_GOOGLE_EMAIL",
  "password": "YOUR_GOOGLE_PASSWORD",
  "twofa": "YOUR_TOTP_SECRET",
  "task_type": "extract"
}

{
  "success": true,
  "message": "任务提交成功",
  "task_id": 168,
  "remaining_uses": 9.0,
  "queue_paused": false
}

{
  "action": "get_status",
  "cdkey": "YOUR_CDK",
  "task_id": 168
}

{
  "success": true,
  "data": {
    "task_id": 168,
    "email": "account@example.invalid",
    "status": "running",
    "display_status": "running",
    "message": "正在执行",
    "error_type": null,
    "completed_at": null,
    "offer_url": null,
    "task_type": "full",
    "retry_count": 0,
    "max_retries": 2,
    "requeue_count": 0,
    "max_requeues": 2,
    "system_recovery_state": "none",
    "last_requeue_reason": null,
    "last_requeued_at": null,
    "queue_duration_seconds": 12
  }
}

{
  "success": true,
  "data": {
    "task_id": 169,
    "email": "account@example.invalid",
    "status": "success",
    "display_status": "success",
    "message": "已提取Offer链接",
    "error_type": null,
    "completed_at": "2026-07-02T10:00:00",
    "offer_url": "https://one.google.com/offer/REDACTED",
    "task_type": "extract",
    "retry_count": 0,
    "max_retries": 2,
    "requeue_count": 0,
    "max_requeues": 2,
    "system_recovery_state": "none",
    "last_requeue_reason": null,
    "last_requeued_at": null,
    "queue_duration_seconds": 4
  }
}

{
  "action": "cancel_task",
  "cdkey": "YOUR_CDK",
  "task_id": 168
}

{
  "success": true,
  "message": "任务已取消并退款"
}

{
  "success": false,
  "message": "任务正在处理中"
}

import os
import requests

cdkey = os.getenv("CLAIM_FARM_CDK")
if not cdkey:
    raise RuntimeError("缺少 CLAIM_FARM_CDK 环境变量")

try:
    response = requests.post(
        "{{API_ENDPOINT}}",
        json={
            "action": "get_balance",
            "cdkey": cdkey,
        },
        timeout=(5, 30),
    )
    response.raise_for_status()
    result = response.json()
except (requests.RequestException, ValueError) as exc:
    raise RuntimeError("API 请求失败，请检查网络、状态码和返回格式") from exc

# 仅输出需要的非敏感字段，不要打印完整响应。
print({
    "success": result.get("success"),
    "remaining_uses": result.get("remaining_uses"),
})

<?php
$cdkey = getenv("CLAIM_FARM_CDK");
if (!$cdkey) {
    throw new RuntimeException("缺少 CLAIM_FARM_CDK 环境变量");
}

$payload = json_encode([
    "action" => "get_balance",
    "cdkey" => $cdkey
], JSON_THROW_ON_ERROR);

$ch = curl_init("{{API_ENDPOINT}}");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS => $payload,
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlError = curl_errno($ch);
curl_close($ch);

if ($body === false || $curlError !== 0 || $status < 200 || $status >= 300) {
    throw new RuntimeException("API 请求失败，HTTP 状态码：" . $status);
}

$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
echo json_encode([
    "success" => $result["success"] ?? false,
    "remaining_uses" => $result["remaining_uses"] ?? null
], JSON_UNESCAPED_UNICODE);

{
  "detail": "Invalid or inactive CDK"
}

{
  "success": false,
  "message": "任务正在处理中"
}