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

Формат ошибки ApiError

Все ошибки API возвращают единую структуру:

{
  "error_type": "ERROR_TYPE_UNAUTHORIZED",
  "code": "INVALID_TOKEN",
  "message": "Токен истёк или недействителен",
  "details": {}
}

Поле	Тип	Описание
error_type	string	Маппится на HTTP-статус: UNAUTHORIZED → 401, RATE_LIMIT → 429, INTERNAL → 500
code	string	Программный код для детальной обработки
message	string	Человекочитаемое сообщение
details	object	Дополнительная информация (например, какое поле неверно)

HTTP-статусы

Код	Описание	Типичная причина
200	Успех	Запрос выполнен
400	Bad Request	Неверные параметры, некорректное тело
401	Unauthorized	Отсутствует или недействителен токен
429	Too Many Requests	Превышен лимит запросов
500	Internal Server Error	Внутренняя ошибка сервера

Где искать коды ошибок для конкретных методов

Все возможные коды ответов для каждого метода перечислены в его карточке в справочнике API:

• DBS
• FBS