--- title: Коды ошибок description: Сводный каталог кодов ошибок HTTP и платформы для контрактов Web & SDK, API и Magic Link. canonical: https://developer.unico.io/ru/dual-api/developers/api-reference/error-codes locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - [Справочник API](/ru/dual-api/developers/api-reference/) - Коды ошибок **На этой странице# Коды ошибок Эта страница является единственным источником достоверной информации по обработке ошибок. Коды ошибок, специфичные для SDK, задокументированы на странице [Обработка ошибок](/ru/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling) каждого SDK; данная страница охватывает ошибки на уровне API-контракта. ### Коды состояния HTTP​ КодЗначениеОбласть применения`200 OK`Запрос выполнен успешно.Все контракты.`201 Created`Ресурс создан (редко; большинство операций создания возвращают `200`).Контракт API.`400 Bad Request`Payload некорректен или отсутствуют обязательные поля. В теле ответа указаны проблемные поля.Все контракты.`401 Unauthorized`Аутентификация отсутствует, просрочена или недействительна.Все контракты.`403 Forbidden`Аутентификация действительна, но тенант не включён для запрошенного ресурса (например, вызов возможности, не входящей в ваш `APIKEY`).Web & SDK, API.`404 Not Found`Ресурс не существует или не принадлежит аутентифицированному тенанту.Все контракты.`409 Conflict`Ресурс существует, но находится не в том состоянии для данной операции (например, получение документов из процесса, который ещё выполняется).Web & SDK, API.`410 Gone`Ресурс существовал, но был удалён согласно политике хранения (эндпоинты получения документов), либо процесс существует, но завершился с ошибкой — см. [Получение процесса](/ru/dual-api/developers/api-reference/api/get-process).Эндпоинты получения документов; API Get Process.`429 Too Many Requests`Превышен [лимит частоты запросов](/ru/dual-api/developers/api-reference/rate-limits). Повторите попытку с экспоненциальной задержкой.Все контракты.`5xx`Ошибка платформы. Повторите попытку с задержкой; если проблема не исчезает, обратитесь в поддержку с телом ответа и временной меткой.Все контракты. ### Ошибки аутентификации (`401`)​ ПричинаСимптомНеверный закрытый ключ (assertion подписан не тем ключом)`401`, `Authentication failed (1.2.21)``aud` не совпадает с URL среды`401`Claim `exp` в прошлом`401`, `Authentication failed`Неподдерживаемый алгоритм (используйте `RS256`)`401`Смешение учётных данных sandbox / production`401`, даже если учётные данные выглядят корректноОтсутствует заголовок `APIKEY` (только контракт API)`401`Недействительный `x-api-key` (только Magic Link)`401` См. [Аутентификация > Типичные ошибки](/ru/dual-api/developers/api-reference/authentication#error-codes) для полного контрольного списка устранения неполадок. ### Результаты на уровне возможностей (`200` с отрицательным результатом)​ Статус `200 OK` **не** означает, что пользователь прошёл верификацию — он означает, что платформа завершила работу. Решение на уровне пользователя содержится в теле ответа, а не в HTTP-статусе: ПолеОтрицательное значениеМесто нахождения`process.result``PROCESS_RESULT_FAILED`Web & SDK`process.authenticationInfo.livenessResult``NO`Web & SDK`liveness``2`API`unicoId.result``no`API`data.response.unico.result``NOT_APPROVED`Magic Link ### Политика повторных попыток​ СтатусПовторять?Как`5xx`ДаЭкспоненциальная задержка (1 с, 2 с, 4 с, 8 с, …). Ограничьте 5 попытками.`429`ДаСоблюдайте заголовок `Retry-After`, если он присутствует; иначе используйте экспоненциальную задержку.`4xx` (другие)НетЗапрос некорректен. Исправьте входные данные перед повторной попыткой.`401`УсловноОбновите токен доступа один раз. Если новый запрос также возвращает `401`, проблема структурная — не повторяйте попытку. ИдемпотентностьПлатформа IDCloud в настоящее время не предоставляет механизм ключа идемпотентности для эндпоинтов создания. Будьте осторожны при повторных попытках `POST /client/v1/process` или `POST /processes/v1` — сетевая ошибка при `5xx` может означать, что операция фактически выполнилась на сервере, и повторная попытка создаст дублирующий процесс. В случае сомнений получите список последних процессов по вашему внутреннему correlation ID перед повторной попыткой. ### Где находятся ошибки SDK​ Каталоги ошибок Web SDK, Android SDK, iOS SDK и Flutter SDK задокументированы на специальной странице **Обработка ошибок** каждого SDK: [Web SDK > Обработка ошибок](/ru/dual-api/developers/sdks-and-tools/web/web-sdk/error-handling) [Android SDK > Обработка ошибок](/ru/developers/sdks-and-tools/android/error-handling) [iOS SDK > Обработка ошибок](/ru/developers/sdks-and-tools/ios/error-handling) [Flutter SDK > Обработка ошибок](/ru/developers/sdks-and-tools/flutter/error-handling) Они охватывают ошибки на стороне устройства (запрет доступа к камере, тайм-аут захвата, недоступность сети на устройстве) — в отличие от ошибок на стороне API, задокументированных здесь.Последнее обновление 8 окт. 2026 г.**