Обработка ошибок

Все ошибки возвращают JSON-объект с полем error. См. аутентификацию для настройки API-ключа и импорт CAR для пакетной загрузки — обе операции возвращают ошибки в этом же формате.

{
  "error": "not enough storage, please upgrade your plan"
}

Коды статусов

Код	Значение	Частые причины
400	Некорректный запрос	Отсутствующие или недопустимые параметры, неподдерживаемый тип содержимого, невалидное тело JSON.
401	Не авторизован	Отсутствующий или недействительный API-ключ.
402	Требуется оплата	Превышен лимит хранилища — обновите план или дождитесь ежемесячного сброса.
404	Не найдено	CID файла или пользователь не найден.
429	Слишком много запросов	Превышен лимит пропускной способности шлюза — дождитесь ежемесячного сброса.
500	Внутренняя ошибка	Непредвиденная ошибка сервера — повторите попытку или обратитесь в поддержку.

Ошибки 4xx (клиентские)

Коды 4xx означают проблему с самим запросом. Проверьте, что ваш API-ключ действителен (401), что тело запроса — корректно сформированный JSON (400), и что лимит хранилища вашего плана не превышен (402).

Ошибки 5xx (серверные)

Ответ 500 означает непредвиденное состояние на стороне сервера. Повторите запрос после небольшой задержки; если ошибка повторяется, обратитесь в поддержку, указав идентификатор запроса из заголовков ответа.