Перейти к содержимому

Ошибки сервиса

Формат ошибок сервиса информации о ККТ и ФН по RFC 7807 и справочник типовых ошибок.

Все ошибки базируются на модели объекта сведений об ошибке RFC 7807 (Problem Details).

Формат ответа с ошибкой

ПолеТипОбяз.Описание
typestringДаСсылка на описание типа ошибки
titlestringДаНазвание ошибки
statusnumberДаКод состояния HTTP
detailstringНетОписание ошибки
instancestringНетURI объекта, относительно которого возникла ошибка
traceIdstringДаИдентификатор ошибки (трассировки)
errorCodestringНетСимвольный код ошибки
errorsobjectНетКоллекция ошибок валидации входной модели: ключ (поле или jsonPath) -> описание

Типовые ошибки

errorCodeОписаниеHTTPКогда возникает
WrongLoginOrPasswordНеверный логин или пароль401Передан неверный логин или пароль в методе авторизации
MissingTokenНе распознан токен запроса401Токен не приложен к запросу или имеет неверный формат
ExpiredTokenПереданный токен не активен401Истек срок действия токена (24 часа)

Остальные ошибки приходят без errorCode - различайте их по status и title:

HTTPtitleКогда возникает
400Ошибка валидацииВ запросе отсутствуют обязательные поля - состав в errors: { "<поле>": ["<описание>"] }
400Ошибка валидацииЗапрос имеет неверный формат JSON - errors: { "<jsonPath>": ["<описание>"] }
403ForbiddenТокен не авторизует пользователя (недостаточно прав)
404Not FoundНекорректный серийный номер ККТ
500Ошибка сервераНеобработанная ошибка сервера
json
{
  "type": "https://tools.ietf.org/html/rfc7235#section-3.1",
  "title": "Переданный токен не активен",
  "status": 401,
  "detail": "Переданный токен не активен",
  "instance": "/api/kkt/v1/cash-registers",
  "traceId": "0HLR9…",
  "errorCode": "ExpiredToken"
}

При получении ExpiredToken запросите новый токен методом авторизации и повторите запрос.