getToken

建立任務，並在同一個請求中等待答案，最長 50 秒。如果屆時任務未完成，回覆為 status processing 加上 taskId；請繼續用 getTaskResult 查詢。getToken 任務不會傳送結果回呼。

POSThttps://unlock-api.com/getToken

此方法請把 HTTP 用戶端逾時設為 60 秒以上。

請求參數

clientKey

String必填

你的 API 金鑰，32 個字元，在帳號頁面上。

task

Object必填

任務物件。其 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
任務未能按時完成辨識。費用已退回餘額。