Описание ошибок

Этот раздел содержит список кодов ошибок, возвращаемых методами API.

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

Все ошибки API возвращаются в стандартном формате JSON:

{
  "message": "Описание ошибки",
  "code": "error_code",
  "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}

Где:

message — текстовое описание ошибки на русском языке.
code — строковый код ошибки для программной обработки.
trace_id — уникальный идентификатор запроса для отладки.

Использование trace_id

Поле trace_id позволяет идентифицировать конкретный запрос в логах сервера. При обращении в поддержку сообщите значение trace_id — это поможет быстро найти информацию о проблеме.

Коды ошибок

Код	HTTP статус	Описание
`AUTHENTICATION_ERROR`	401	Отсутствует или недействителен токен авторизации.
`FORBIDDEN_ERROR`	403	Недостаточно прав для выполнения операции.
`VALIDATION_ERROR`	400	Некорректные данные запроса или ошибка валидации.
`UNSUPPORTED_MEDIA_TYPE`	415	Неподдерживаемый Content-Type. Ожидается: `application/json`, `application/merge-patch+json` или `multipart/form-data`.
`LIMIT_EXCEEDED`	400	Превышен лимит на количество сущностей.
`NOT_FOUND`	404	Запрашиваемый ресурс не найден.
`CONFLICT`	409	Конфликт данных (например, попытка создать дубликат).
`UNKNOWN_ERROR`	500	Внутренняя ошибка сервера.

Была ли статья полезна?

Авторизация

Ограничения запросов