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 на странице аккаунта.
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
Задачу не удалось решить вовремя. Деньги за неё вернулись на баланс.