Коды ошибок

Формат ошибок API и что делать при каждом статусе.

Все ошибки возвращаются в едином формате:

Тело ошибки
{
  "message": "Лимит исчерпан. Продлите лицензию или докупите пакет."
}

Статусы#

Код

Причина

Что делать

400

Файл не передан, это не изображение или он больше 15 МБ.

Проверьте поле file, формат и размер.

401

Ключ доступа не передан или не найден.

Проверьте заголовок и актуальность ключа в кабинете.

402

Лимит исчерпан или его не хватает на найденные документы.

Докупите пакет либо дождитесь следующего периода.

403

Лицензия неактивна или ключ выдан для другого продукта.

Проверьте статус лицензии и продукт, которому принадлежит ключ.

429

Превышено ограничение частоты — 5 запросов в секунду на лицензию.

Повторите запрос позже, разнесите нагрузку во времени.

503

Сервис распознавания временно недоступен.

Повторите запрос позже с тем же ключом идемпотентности.

500

Внутренняя ошибка.

Повторите запрос; если ошибка повторяется — напишите в поддержку.