Ошибки
Коды HTTP и значения поля status.
Поиск и проверка
Результат запроса — в поле status ответа:
status | HTTP | Что значит | Что делать |
|---|---|---|---|
ok | 200 | Данные найдены — в поле result. | — |
not_found | 200 | Сервис отработал, данных по запросу нет. | Проверьте написание ФИО, даты и номеров. |
bad_request | 400 | Запрос не прошёл проверку: нет обязательного поля или неверный формат. Пояснение — в ответе. | Исправьте запрос. Поле request_body показывает, как сервис понял запрос. |
access_denied | 403 | Ключ не подошёл или метод недоступен вашей учётной записи. | Проверьте заголовок X-Api-Key, при необходимости обратитесь к менеджеру. |
error | 500 и др. | Источник данных не ответил или ответил ошибкой. | Повторите запрос позже. Если ошибка повторяется — сообщите менеджеру request_id. |
Часть ошибок приходит не в этом формате, а в стандартном application/problem+json
(title, status, detail, при ошибках проверки — errors с перечнем полей):
| HTTP | Когда |
|---|---|
| 400 | Тело запроса не разобрано или нет обязательного поля — у методов ФССП. Ошибки по полям — в errors. |
| 401 | Ключ не подошёл — у методов ФССП, банкротства и решений судов (у остальных — 403 access_denied). |
| 500 | Не передан заголовок X-Api-Key; у методов банкротства и решений судов — также если не хватает обязательных полей. Проверьте запрос по описанию полей на странице метода. |
Какие ответы возможны у конкретного метода — на его странице.
Подача в суды и статусы обращений
| HTTP | Что значит |
|---|---|
| 200 | Запрос обработан — результат подачи в теле ответа. |
| 400 | Запрос не прошёл проверку: например, нет обязательного поля в fillData, не найден файл по fileIndex или значение отсутствует в справочнике. Текст — в поле error. |
| 403 | Ключ не подошёл (status: access_denied). |
| 500 | Ошибка при подаче: портал недоступен, сессия портала истекла и т. п. Текст — в поле error. |
Ошибку входа на портал («Требуется передать cookies…», истёкшая сессия) исправляет новый вход через Госуслуги — см. Авторизация.
Перед повтором подачи после ошибки 500 проверьте статус обращения: подача могла дойти до портала,
а ответ — потеряться. Повтор без проверки может отправить заявление дважды.