Главная›API›Методы

createTask

Создание задачи

#Описание

Метод создаёт задачу на решение капчи. В параметрах передаются ключ клиента и описание задачи (тип капчи и её данные).

Адрес метода

POSThttps://api.tokenwave.org/createTask

Формат запроса: JSON POST

#Параметры запроса

clientKeystringобязательный

Ваш API-ключ: 32 символа (цифры и буквы a–f). Берётся в боте по кнопке Мой ключ и передаётся в каждом запросе.
Пример: 67b6bcbb1a728ea8d563de6d169a2057

taskobjectобязательный

Объект с описанием задачи: тип капчи, адрес страницы, ключ и параметры сессии. Все поля описаны в разделе HCaptchaTask.

#Пример запроса

curl -X POST https://api.tokenwave.org/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "ВАШ_КЛЮЧ",
    "task": {
      "type": "HCaptchaTask",
      "websiteURL": "https://store.steampowered.com/join/",
      "websiteKey": "e18a349a-46c2-46a0-87a8-74be79345c92",
      "data": "14233456855421534",
      "isInvisible": true,
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36",
      "cookies": "sessionid=0123456789abcdef01234567; browserid=1234567890123456789"
    }
  }'

import requests

resp = requests.post("https://api.tokenwave.org/createTask", json={
    "clientKey": "ВАШ_КЛЮЧ",
    "task": {
        "type": "HCaptchaTask",
        "websiteURL": "https://store.steampowered.com/join/",
        "websiteKey": "e18a349a-46c2-46a0-87a8-74be79345c92",
        "data": "14233456855421534",
        "isInvisible": True,
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36",
        "cookies": "sessionid=0123456789abcdef01234567; browserid=1234567890123456789",
    },
}).json()
print(resp)

const resp = await fetch("https://api.tokenwave.org/createTask", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    clientKey: "ВАШ_КЛЮЧ",
    task: {
      type: "HCaptchaTask",
      websiteURL: "https://store.steampowered.com/join/",
      websiteKey: "e18a349a-46c2-46a0-87a8-74be79345c92",
      data: "14233456855421534",
      isInvisible: true,
      userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/153.0.0.0 Safari/537.36",
      cookies: "sessionid=0123456789abcdef01234567; browserid=1234567890123456789",
    },
  }),
}).then((r) => r.json());
console.log(resp);

См. инструкцию, как найти нужные параметры, — в разделе Где взять параметры.

#Структура ответа

errorIdinteger

Признак ошибки. 0 — ошибок нет, задача создана, её идентификатор в taskId. 1 — ошибка, её код в errorCode.

errorCodestring

Код ошибки, например ERROR_ZERO_BALANCE. Поле есть только при errorId: 1. Все коды — в разделе Коды ошибок.

errorDescriptionstring

Текст ошибки на английском языке для человека. В коде ориентируйтесь на errorCode.

taskIdinteger

Идентификатор созданной задачи (целое число) для метода getTaskResult. Задача хранится 5 минут и доступна только вашему ключу.
Пример: 7654321

#Пример ответа

Без ошибки:

json

{ "errorId": 0, "taskId": 7654321 }

С ошибкой:

json

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "Account authorization key not found in the system."
}