Коды ответов и ошибки

Сервис Verification возвращает ошибки как на уровне HTTP‑статусов, так и в теле ответа/Callback.
Ниже приведены общие подходы к обработке ошибок.

HTTP‑коды

Типичные коды HTTP‑ответов:

• 200 OK — запрос успешно принят в обработку, тело содержит результат;
• 400 Bad Request — ошибка валидации входных данных (несоответствие типам, отсутствуют обязательные поля и т.п.);
• 401 Unauthorized — некорректный или отсутствующий JWT‑токен;
• 403 Forbidden — недостаточно прав доступа;
• 404 Not Found — запрошенный ресурс не найден (например, неверный идентификатор запроса при получении результата);
• 429 Too Many Requests — превышены квоты/лимиты;
• 500 Internal Server Error — внутренняя ошибка сервиса.

Точный перечень кодов и их интерпретацию следует уточнять в актуальной спецификации API.

Ошибки в теле ответа

В теле ответа и callback‑уведомления могут передаваться:

• общие статусы запроса на верификацию;
• статусы отдельных проверок (источников);
• коды и описания ошибок по каждому источнику.

Примеры типичных проблем:

• некорректные или неполные персональные данные для passportVerification/inn;
• отсутствие обязательных полей для esiaAccountVerification или скорингов;
• технические ошибки при обращении к внешним реестрам.

Рекомендуется:

• обрабатывать как HTTP‑код, так и содержимое тела ответа;
• логировать verificationExternalId и подробности ошибки;
• при необходимости реализовать ретраи с учётом идемпотентности операций.

Структура блока ошибок и статусов подробно приводится в разделе
«API Reference → Verification API → Result».