getToken

创建任务并在同一个请求中等待答案，最长 50 秒。如果届时任务未完成，会返回 status processing 和 taskId；请继续用 getTaskResult 查询。getToken 任务不发送结果回调。

POSThttps://unlock-api.com/getToken

调用此方法时，请把 HTTP 客户端超时设为 60 秒以上。

请求参数

clientKey

String必填

你的 API 密钥，32 个字符，在账户页面上。

task

Object必填

task 对象。其中的 type 字段决定还需要哪些字段。任务类型

softId

Integer可选

你的应用 ID，随任务一起保存。appId 也作为同一字段接受。

请求

POST /getToken

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

响应

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640011,
  "solveCount": 1
}

{
  "errorId": 0,
  "status": "processing",
  "taskId": 1001
}

响应字段

errorId

Integer

请求成功为 0，失败为 1。

taskId

Integer

任务 ID。

status

String

识别中为 processing，完成后为 ready。

solution

Object

答案。其字段取决于任务类型。

cost

String

此任务的价格，单位为美元。

代码示例

curl -s https://unlock-api.com/getToken \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}}'

import requests

r = requests.post("https://unlock-api.com/getToken", json={
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "TurnstileTaskProxyless",
        "websiteURL": "https://example.com/login",
        "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
}).json()
print(r)

const r = await fetch("https://unlock-api.com/getToken", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "TurnstileTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
  }),
}).then((res) => res.json());
console.log(r);

此方法可能返回的错误

ERROR_KEY_DOES_NOT_EXIST
密钥错误。请从账户页面重新复制。（in.php 和 res.php：ERROR_WRONG_USER_KEY）
ERROR_IP_NOT_ALLOWED
请求来自不在账户白名单中的 IP。请在账户页面添加该 IP。
ERROR_IP_BANNED
该账户已被封禁。请从账户页面联系客服。
ERROR_TOO_MANY_REQUESTS
请求过多。请把结果查询放慢到每 5 秒一次。
ERROR_ZERO_BALANCE
余额不足以支付该任务。请充值；本次未扣费。
ERROR_NO_SLOT_AVAILABLE
当前请求过多，任务未被接受。请几秒后重试；本次未扣费。
ERROR_TASK_NOT_SUPPORTED
任务类型未知或已关闭。请检查类型名称。
ERROR_BAD_PARAMETERS
缺少必填字段或字段格式错误。
ERROR_PAGEURL
缺少 websiteURL 或 pageurl，或不是完整的 http(s) 地址。
ERROR_CAPTCHA_UNSOLVABLE
任务未能按时完成识别。费用已退回余额。