Формат
{
"error": "invalid_api_key"
}
Ошибки API
Большинство ошибок возвращается JSON-объектом с полем error. Для converter-ошибок также может быть поле message.
Таблица ошибок
| HTTP | Код | Где возникает | Что делать |
|---|---|---|---|
| 400 | invalid_json | JSON endpoints | Проверить тело запроса и заголовок Content-Type. |
| 400 | invalid_email | Auth | Передать корректный email. |
| 400 | email_domain_not_allowed | Auth | Использовать email с разрешённым доменом. |
| 400 | invalid_key_id | Keys, Usage | Передать корректный Mongo ObjectId ключа. |
| 400 | invalid_plan_code | Billing | Использовать один из plan codes из документации оплаты. |
| 401 | auth_required | Cabinet API | Войти в кабинет и передать cookie sid. |
| 401 | invalid_code | Auth | Запросить новый email-код. |
| 401 | invalid_api_key | Optimize API | Проверить Bearer API-ключ и статус ключа. |
| 402 | paid_quota_exhausted | Optimize API | Купить новый пакет или дождаться новой подписки. |
| 404 | key_not_found | Keys | Проверить, что ключ принадлежит текущему пользователю. |
| 429 | daily_limit_exceeded | Optimize API | Дождаться следующего дня UTC или оплатить пакет. |
| 502 | converter_unavailable | Optimize API | Повторить запрос позже. |
Частичные ошибки файлов
В batch-запросе отдельный файл может вернуться с success: false, а общий ответ всё ещё будет содержать результаты по остальным файлам.
{
"success": true,
"message": "optimized 1 file(s), 1 failed",
"results": [
{ "filename": "ok.jpg", "success": true },
{ "filename": "bad.txt", "success": false, "message": "cannot decode image" }
]
}