GetRecognized

GetRecognized

Имя ресурса: /GetRecognized

HTTP метод: GET

Параметры строки запроса:

• recognitionId - идентификатор задачи на распознавание, статус или результат которой нас интересует;

В запросе должен присутствовать HTTP-заголовок Authorization с необходимыми данными для авторизации.

В случае успеха в теле ответа содержится статус существующей задачи на распознавание, либо результат распознавания, если задача уже завершилась. Тело ответа сериализуется в протобуфер Recognized. Задачи на распознавание создаются при помощи метода Recognize.

Если задача на распознавание еще не была выполнена, то в ответе в HTTP-заголовке Retry-After указывается время (в секундах), через которое можно повторить запрос для получения результатов распознавания. Тело ответа в этом случае отсутствует.

Возможные HTTP-коды возврата:

• 200 (OK) - операция успешно завершена;

• 400 (Bad Request) - данные в запросе имеют неверный формат или отсутствуют обязательные параметры;

• 401 (Unauthorized) - в запросе отсутствует HTTP-заголовок Authorization, или в этом заголовке содержатся некорректные авторизационные данные;

• 404 (Not Found) - результаты распознавания еще не доступны; можно повторить попытку их получения позже;

• 405 (Method not allowed) - используется неподходящий HTTP-метод;

• 409 (Conflict) - неизвестный, либо слишком старый идентификатор задачи на распознавание; имеет смысл повторить создание задачи на распознавание.

• 500 (Internal server error) - при обработке запроса возникла непредвиденная ошибка.