Ошибки: что делать дальше
Обновлено 8 октября 2026
Сначала проверьте HTTP-статус и Content-Type. Обычно detail.error содержит код ошибки. detail.message содержит пояснение. detail.file содержит имя проблемного файла. Ответ 422 может содержать список ошибок или объект с кодом.
Входной сервер может вернуть HTML.
Типичный ответ
{"detail":{"error":"idempotency_conflict","message":"Этот ключ уже использован для другого комплекта"}}| HTTP / код | Что означает | Что делать |
|---|---|---|
| 400 no_files / bad_format | Нет файлов или пригодных для обработки документов. | Проверьте поля files, файлы и содержимое архива. |
| 400 too_many_files / 413 too_big | Превышен предел подключения. | Проверьте /limits. Уменьшите объём или согласуйте увеличение лимита. |
| 401 unauthorized | Ключ отсутствует, неверен или отозван. | Проверьте Authorization: Bearer и ключ. |
| 402 no_checks_left | Недостаточно доступных проверок. | Проверьте /me и условия доступа. |
| 403 forbidden | Доступ организации приостановлен. | Обратитесь к тому, кто подключал организацию. |
| 404 not_found / no_report | Объект не найден либо результат ещё не опубликован. | Проверьте run_id и его статус. Чужие проверки не раскрываются. |
| 409 idempotency_pending | Сервер ещё обрабатывает первую отправку. | Подождите. Повторите тот же запрос с прежним Idempotency-Key. |
| 409 idempotency_conflict | Метка уже связана с другим запросом. | Для нового комплекта задайте новую метку. При потере ответа сохраните прежнюю метку. |
| 409 section_unavailable / thematic_unavailable | Отчёт не содержит привязки к нужному разделу или группе. | Получите общий PDF. Проверьте available_sections. |
| 400 bad_section / bad_theme / conflicting_filters / section_pdf_only | Неверный фильтр отчёта. | Выберите один допустимый фильтр. section используется с PDF. |
| 409 report_changed / version_conflict | Изменилась версия отчёта или решения. | Получите актуальный результат. Получите историю решений. Затем подтвердите своё изменение. |
| 409 idempotency_conflict при feedback | request_key решения повторён с другим содержимым. | Для нового решения используйте новую метку request_key. |
| 409 discipline_already_assigned | Раздел уже назначен сотруднику. | Проверьте назначение сотрудника через кабинет. Возможность доступна только в отдельных подключениях. |
| 422 | Неверный тип, длина или значение параметра. | Исправьте данные по detail и справочнику метода. |
| 429 / сетевой сбой / 5xx | Временная недоступность. | Повторите чтение с паузой. При повторе загрузки сохраните прежний Idempotency-Key. |
| 503 pdf_unavailable | PDF сейчас не собран. | Сохраните /findings и /report. Повторите запрос PDF позже. |
| 503 backend_unavailable / profile_broken | Подключение временно недоступно. | Повторите запрос позже. Если ошибка остаётся, обратитесь в поддержку. |
| 507 storage_full_retry | Сейчас недостаточно места для приёма. | Повторите позже с тем же Idempotency-Key. |
В обращении в поддержку укажите время запроса, HTTP-статус и код ошибки. Если получили run_id, укажите его. Не добавляйте ключ доступа в обращение или журналы.