getTaskResult: запрос результата задачи
Когда задача, созданная с помощью createTask, является асинхронной, результат асинхронной задачи можно получить через getTaskResult.
- Максимальное количество запросов на получение результатов для каждой задачи - 120. Когда количество запросов превышает это число, результаты задачи будут утеряны.
- Каждую задачу можно запросить в течение 5 минут после ее создания, и результат будет утерян после истечения этого времени.
- Результат распознавания, полученный с помощью этого метода, зависит от нагрузки на систему, и вы получите результат в интервале времени от 1 секунды до 30 секунд.
WARNING
Обратите внимание, что не все задачи нужно получать таким образом. Для следующих двух задач нужно проверять документы.
- Задачи класса идентификации, такие как ImageToText и другие, синхронизируются непосредственно через createTask и возвращают результаты.
Пример запроса
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
}
Параметры запроса
Параметры | Тип | Обязательно | Описание |
---|---|---|---|
clientKey | string | Yes | Ключ клиентского аккаунта, который можно найти здесь |
taskId | string | Yes | ID, созданный методом createTask |
Пример ответа
{
"errorId": 0,
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}
Структура ответа
Параметры | Тип | Описание |
---|---|---|
errorId | Integer | Сообщение об ошибке: 0 - нет ошибки 1 - ошибка |
errorCode | String | errorCode: полный список ошибок |
errorDescription | String | Описание ошибки |
status | String | • idle - Ожидание • processing - Идентификация • ready - Идентификация завершена и результат находится в параметре solution |
solution | Object | Данные результата задачи. Разные для каждого типа задачи |
Спецификация ответа
-
Успешное распознавание: Когда
errorId
равно0
иstatus
равноready
, результат находится вsolution
. -
Идентификация: Когда
errorId
равно0
иstatus
равноprocessing
, повторите попытку через 3 секунды. -
Ошибка: Когда
errorId
больше0
, обратитесь к информации об ошибке вerrorDescription
.