getToken

タスクを作成し、同じリクエスト内で最大50秒まで答えを待ちます。それまでに完了しない場合は、status processingとtaskIdが返ります。その後はgetTaskResultで確認を続けてください。getTokenのタスクには結果コールバックは送信されません。

POSThttps://unlock-api.com/getToken

このメソッドでは、HTTPクライアントのタイムアウトを60秒より長く設定してください。

リクエストパラメータ

clientKey

String必須

アカウントページにある32文字のAPIキーです。

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
時間内にタスクを解決できませんでした。料金は残高に戻っています。