Skip to content
On this page
Home
>API
>getTaskResult: Результат задачи

getTaskResult: запрос результата задачи

Когда задача, созданная с помощью createTask, является асинхронной, результат асинхронной задачи можно получить через getTaskResult.

  1. Максимальное количество запросов на получение результатов для каждой задачи - 120. Когда количество запросов превышает это число, результаты задачи будут утеряны.
  2. Каждую задачу можно запросить в течение 5 минут после ее создания, и результат будет утерян после истечения этого времени.
  3. Результат распознавания, полученный с помощью этого метода, зависит от нагрузки на систему, и вы получите результат в интервале времени от 1 секунды до 30 секунд.

WARNING

Обратите внимание, что не все задачи нужно получать таким образом. Для следующих двух задач нужно проверять документы.

  • Задачи класса идентификации, такие как ImageToText и другие, синхронизируются непосредственно через createTask и возвращают результаты.

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

json
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
    "clientKey":"YOUR_API_KEY",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // ID, созданный методом createTask
}

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

ПараметрыТипОбязательноОписание
clientKeystringYesКлюч клиентского аккаунта, который можно найти здесь
taskIdstringYesID, созданный методом createTask

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

json
{
    "errorId": 0,
    "solution": {
        "userAgent": "xxx",
        "gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
    },
    "status": "ready"
}

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

ПараметрыТипОписание
errorIdIntegerСообщение об ошибке:
0 - нет ошибки
1 - ошибка
errorCodeStringerrorCode: полный список ошибок
errorDescriptionStringОписание ошибки
statusString• idle - Ожидание
• processing - Идентификация
• ready - Идентификация завершена и результат находится в параметре solution
solutionObjectДанные результата задачи. Разные для каждого типа задачи

Спецификация ответа

  • Успешное распознавание: Когда errorId равно 0 и status равно ready, результат находится в solution.

  • Идентификация: Когда errorId равно 0 и status равно processing, повторите попытку через 3 секунды.

  • Ошибка: Когда errorId больше 0, обратитесь к информации об ошибке в errorDescription.

    errorCode: полный список ошибок