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

Формат ответа при ошибках, типовые HTTP-статусы и их значения.

Формат ошибки `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	Дополнительная информация (например, какое поле неверно)

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

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