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
任務未能在時限內識別。費用已退回你的餘額。