getToken

Створює задачу й чекає на відповідь у тому самому запиті, до 50 секунд. Якщо на той час задача не готова, відповідь приходить зі status processing і taskId; далі перевіряйте її через getTaskResult. Callback з результатом для задач 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 акаунта. Додайте цю 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
Задачу не вдалося розв'язати вчасно. Кошти повернуто на баланс.