Обработка ошибок
Вся обработка ошибок Web SDK сосредоточена в этом разделе. Callback error получает объект ErrorBio, предоставляющий методы getCode() и getDescription().
Ошибки prepareCamera
| Код | Описание |
|---|---|
73000 | Неизвестная и непредвиденная ошибка при обычном использовании API SDK |
73001 | <property> обязателен |
73002 | <property> должен быть экземпляром <class> |
73003 | <class> с именем <name> недоступен для внедрения |
73004 | Тип класса должен быть функцией или классом |
73005 | Не удалось найти локаль <locale> |
73006 | Не удалось найти текст: <text> |
73100 | Невозможно подключиться к интернету |
73200 | Не удалось найти JSON-файл Unico SDK |
73201 | Не удалось загрузить JSON-файл Unico SDK |
73202 | JSON-файл Unico SDK недействителен |
73204 | Невозможно инициализировать SDK — настройте среду через setEnvironment при сборке |
73300 | Не удалось аутентифицировать это приложение |
73301 | Не удалось аутентифицировать это приложение |
73302 | Токен аутентификации не найден |
73303 | Текущий хост не зарегистрирован |
73400 | Не удалось инициализировать камеру |
73401 | Не удалось загрузить модели ML для этой камеры |
73402 | Ключ не удалось проверить из-за проблем с подключением на устройстве пользователя |
73403 | Данная комбинация устройство/платформа/браузер/версия не поддерживается SDK |
73404 | Устройств о находится в горизонтальной ориентации. SDK можно использовать только в вертикальной ориентации |
73405 | Устройство заблокировано из-за множества неудачных попыток |
73406 | Инициализация камеры была заблокирована — SDK был открыт в iFrame во время prepareCamera |
73407 | SDK не был полностью загружен |
73500 | Не удалось получить сессию |
73501 | Не удалось получить сессию |
73502 | Токен сессии не найден |
73600 | Не удалось найти ресурс камеры |
73601 | Не удалось запустить камеру в режиме production |
74000 | Недопустимое шестнадцатеричное значение |
74001 | Объект не является UnicoTheme |
Ошибки openCamera
| Код | Описание |
|---|---|
73700 | Не удалось разобрать ответ камеры |
73704 | Пользователь нажал кнопку отмены и не завершил сессию |
73706 | Доступ к камере запрещён — пользователь явно отклонил разрешение или политика устройства блокирует его |
73707 | Сессия была отменена из-за завершения работы приложения, перехода в спящий режим, уведомления ОС или перевода в фоновый режим |
73708 | Сессия была отменена, так как устройство находится в горизонтальной ориентации |
73710 | Сессия была отменена, так как пользователь не смог завершить её в отведённое время |
73715 | Сессия была отменена, так как настроены не все направляющие изображения |
73716 | Сессия была отменена, так как SDK не смог запустить камеру на этом устройстве |
73717 | Сессия была отменена, так как пользователь находится в заблокированном состоянии |
73718 | Неизвестная и непредвиденная ошибка при обычном использовании API SDK |
73720 | Разработчик программно вызвал API отмены сессии |
73721 | Сессия была отменена из-за изменения ориентации устройства в ходе сессии |
73722 | Сессия была отменена, так как документ не готов |
73723 | Сессия была отменена, так как выполняется другая сессия |
73724 | Активная се ссия была отменена, так как сессия камеры была запущена внутри iFrame |
73728 | Ошибка подключения — используйте HTTPS для подключения |
73729 | Браузер не поддерживается — откройте в другом браузере |
73730 | Невозможно инициализировать сессию active liveness — неизвестная ошибка лицензии |
73731 | Невозможно инициализировать сессию active liveness — срок действия лицензии истёк |
73732 | Невозможно инициализировать сессию active liveness — источник не разрешён |
73800 | Не удалось зашифровать ответ |
73900 | Не удалось получить системную информацию |
Официальный каталог ошибок
Приведённые коды отражают каталог Web SDK. Официальный кроссплатформенный каталог кодов ошибок доступен в разделе Справочник API > Коды ошибок.
Обработка callback
const callback = {
on: {
success: (obj) => {
console.log(obj.base64);
console.log(obj.encrypted);
},
error: (error) => {
const code = error.getCode();
const description = error.getDescription();
// handle error
}
}
};
Обязательный callback
Объект callback обязателен. Если он реализован некорректно (без обоих событий success и error), SDK генерирует исключение, которое при отсутствии обработки отображается в консоли пользователя.