getTaskResult

Результат задачи

#Описание

После создания задачи периодически запрашивайте её статус. Опрашивайте не чаще одного раза в 2–3 секунды. Задача хранится 5 минут после создания, результат нужно забрать в этот срок.

Адрес метода

POSThttps://api.tokenwave.org/getTaskResult

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

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

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

Ваш API-ключ. Результат можно получить только по задаче, созданной этим же ключом.

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

Идентификатор из ответа createTask (целое число).
Пример: 7654321

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

curl -X POST https://api.tokenwave.org/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{"clientKey": "ВАШ_КЛЮЧ", "taskId": 7654321}'

import requests

res = requests.post("https://api.tokenwave.org/getTaskResult", json={
    "clientKey": "ВАШ_КЛЮЧ",
    "taskId": 7654321,
}).json()
print(res["status"])

const res = await fetch("https://api.tokenwave.org/getTaskResult", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ clientKey: "ВАШ_КЛЮЧ", taskId: 7654321 }),
}).then((r) => r.json());
console.log(res.status);

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

errorIdinteger

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

errorCodestring

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

statusstring

processing — задача решается, запросите результат позже; ready — решение готово, оно в solution. Если решить не удалось, придёт ошибка ERROR_CAPTCHA_UNSOLVABLE.

solutionobject

Решение задачи, есть только при status: ready. Для hCaptcha: gRecaptchaResponse — токен для запроса Steam (одноразовый, живёт 60 секунд) и userAgent — User-Agent, с которым решалась капча; если он вернулся, используйте его; respKey — значение hcaptcha.getRespKey(), если оно есть (для страниц Steam, как правило, отсутствует). Подробнее — в разделе HCaptchaTask.

coststring

Стоимость решённой задачи в долларах, строка с шестью знаками после запятой. Есть только при status: ready.
Пример: 0.004000

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

Задача в работе:

json

{ "errorId": 0, "status": "processing" }

Решение готово:

json

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "P1_eyJ0eXAiOiJKV1Qi…",
    "respKey": "E0_eyJ0eXAiOiJKV1Qi…",
    "userAgent": "Mozilla/5.0 …"
  },
  "cost": "0.004000"
}

Не решено (деньги за задачу не списываются):

json

{
  "errorId": 1,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "The captcha could not be solved. This is usually a temporary condition, try again."
}