Коди помилок

Rekognita API використовує стандартні HTTP-коди відповідей та додає деталізовані error codes для точної діагностики проблем.

HTTP коди

Код	Назва	Опис
`200`	OK	Запит успішний
`201`	Created	Ресурс створено
`400`	Bad Request	Невірний формат запиту або параметри
`401`	Unauthorized	Невірний або відсутній API-ключ
`403`	Forbidden	Ключ не має доступу до цієї операції
`404`	Not Found	Ресурс не знайдено
`413`	Payload Too Large	Файл перевищує максимальний розмір
`415`	Unsupported Media Type	Формат файлу не підтримується
`422`	Unprocessable Entity	Документ неможливо обробити
`429`	Too Many Requests	Перевищено ліміт запитів
`500`	Internal Server Error	Помилка на стороні Rekognita
`503`	Service Unavailable	Сервіс тимчасово недоступний

Формат помилки

{
  "error": {
    "code": "invalid_file_type",
    "message": "Формат файлу .exe не підтримується. Підтримувані формати: pdf, docx, xlsx, jpg, png, tiff",
    "param": "file",
    "doc_url": "https://docs.rekognita.com/supported-files"
  }
}

Детальні error codes

Code	Опис	Рішення
`invalid_api_key`	Невірний API-ключ	Перевірте ключ в Dashboard
`expired_api_key`	Ключ деактивовано	Створіть новий ключ
`invalid_file_type`	Непідтримуваний формат	Див. підтримувані типи
`file_too_large`	Файл занадто великий	Зменшіть розмір або розбийте
`page_limit_exceeded`	Занадто багато сторінок	Обробляйте частинами
`rate_limit_exceeded`	Перевищено ліміт запитів	Зачекайте Retry-After
`processing_failed`	Помилка обробки	Спробуйте ще раз або змініть модель
`insufficient_credits`	Недостатньо кредитів	Поповніть баланс
`schema_validation_failed`	Невірна JSON-схема	Перевірте формат схеми