Manejo de errores

Todo el manejo de errores del Web SDK está centralizado en esta sección. El callback error recibe un objeto ErrorBio que expone getCode() y getDescription().

prepareCamera errors

Código	Descripción
`73000`	Error desconocido e inesperado durante el uso normal de las APIs del SDK
`73001`	`<property>` es obligatorio
`73002`	`<property>` debe ser una instancia de `<class>`
`73003`	`<class>` con nombre `<name>` no está disponible para inyección
`73004`	El tipo de clase debe ser una función o una clase
`73005`	No se pudo encontrar la configuración regional `<locale>`
`73006`	No se pudo encontrar el texto: `<text>`
`73100`	No se puede conectar a internet
`73200`	No se pudo encontrar el archivo JSON del SDK de Unico
`73201`	No se pudo cargar el archivo JSON del SDK de Unico
`73202`	El archivo JSON del SDK de Unico no es válido
`73204`	No se puede inicializar el SDK — configure el entorno mediante `setEnvironment` en la compilación
`73300`	No se pudo autenticar esta aplicación
`73301`	No se pudo autenticar esta aplicación
`73302`	No se encontró el token de autenticación
`73303`	El host actual no está registrado
`73400`	No se pudo inicializar la cámara
`73401`	No se pudieron cargar los modelos de ML para esta cámara
`73402`	La clave no pudo verificarse debido a problemas de conectividad en el dispositivo del usuario
`73403`	Esta combinación de dispositivo/plataforma/navegador/versión no es compatible con el SDK
`73404`	El dispositivo está en orientación horizontal. El SDK solo puede usarse en modo vertical
`73405`	Dispositivo bloqueado debido a múltiples intentos fallidos
`73406`	La sesión fue cancelada — el SDK se abrió en un iFrame
`73407`	El SDK no se cargó completamente
`73500`	No se pudo obtener la sesión
`73501`	No se pudo obtener la sesión
`73502`	No se encontró el token de sesión
`73600`	No se pudo encontrar el recurso de cámara
`73601`	No se pudo iniciar la cámara en modo de producción
`74000`	Hexadecimal no válido
`74001`	El objeto no es un `UnicoTheme`

openCamera errors

Código	Descripción
`73700`	No se pudo analizar la respuesta de la cámara
`73704`	El usuario presionó el botón de cancelar y no completó la sesión
`73706`	Acceso a la cámara denegado — el usuario denegó explícitamente el permiso o la política del dispositivo lo bloquea
`73707`	La sesión fue cancelada porque la aplicación fue terminada, entró en reposo, recibió una notificación del SO o pasó a segundo plano
`73708`	La sesión fue cancelada porque el dispositivo está en modo horizontal
`73710`	La sesión fue cancelada porque el usuario no pudo completarla dentro del tiempo límite asignado
`73715`	La sesión fue cancelada porque no todas las imágenes de guía fueron configuradas
`73716`	La sesión fue cancelada porque el SDK no pudo iniciar la cámara en este dispositivo
`73717`	La sesión fue cancelada porque el usuario estaba en estado bloqueado
`73718`	Error desconocido e inesperado durante el uso normal de las APIs del SDK
`73720`	El desarrollador canceló programáticamente la sesión mediante la API de cancelación
`73721`	La sesión fue cancelada debido a un cambio de orientación del dispositivo durante la sesión
`73722`	La sesión fue cancelada porque el documento no está listo
`73723`	La sesión fue cancelada porque había otra sesión en curso
`73724`	La sesión fue cancelada porque la cámara se abrió en un iFrame
`73728`	Error de conexión — utilice HTTPS para conectarse
`73729`	Navegador no compatible — ábralo en otro navegador
`73730`	No se puede inicializar una sesión de liveness activo — error de licencia desconocido
`73731`	No se puede inicializar una sesión de liveness activo — licencia vencida
`73732`	No se puede inicializar una sesión de liveness activo — el origen no está permitido
`73800`	No se pudo cifrar la respuesta
`73900`	No se pudo obtener información del sistema

Catálogo oficial de errores

Los códigos anteriores reflejan el catálogo del Web SDK. El catálogo oficial de códigos de error multiplataforma está disponible en Referencia de API > Códigos de error.

Manejo del 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 obligatorio

El objeto callback es obligatorio. Si no está correctamente implementado (cubriendo tanto los eventos success como error), el SDK lanza una excepción que, si no se maneja, se muestra en la consola del usuario.