Ошибки
Ошибка запроса — код HTTP и JSON с полем detail: строкой с объяснением или, у 422, списком ошибок по полям.
{ "detail": "Файл не найден или истёк" }| Код | Когда | Что делать |
|---|---|---|
400 | Ссылка на результат запрошена до завершения операции; неверный запрос. | Дождитесь done; проверьте запрос. |
401 | Нет ключа, ключ неверный, перевыпущен или удалён. | Проверьте заголовок X-API-Key. |
402 | На балансе не хватает денег или исчерпан лимит ключа. В detail — что именно и сколько стоит запрос. Ничего не списано. | Пополните баланс или поднимите лимит ключа в кабинете. |
404 | file_id не найден или истёк (час), task_id не найден. | Загрузите файл заново. |
410 | Срок хранения результата истёк, файл удалён или ссылка на бесплатном тарифе уже выдана. | Запустите операцию заново. |
413 | Файл больше лимита тарифа. | Сожмите или разделите файл. |
415 | Формат не поддерживается или содержимое не совпадает с типом. | Проверьте файл и его расширение. |
422 | Ошибка в параметрах; у распознавания текста — больше 100 страниц (без списания). | Исправьте запрос по detail. |
429 | Слишком много запросов — см. лимиты. | Подождите и повторите; учитывайте Retry-After. |
503 | Сервис обработки временно недоступен; оплата вернулась. | Повторите позже. |
Ошибки обработки
Если файл приняли, но обработать не удалось, запрос операции успешен (202), а задача получает статус failed. В поле error — причина, понятная человеку: например, неверный пароль у снятия защиты или повреждённый PDF. Оплата за такую операцию возвращается на баланс автоматически.
Ответы 429 без JSON
Ограничение частоты по IP срабатывает до приложения, поэтому такой 429 может прийти не в JSON. Ориентируйтесь на код ответа.