Códigos de resultado de servicio

Tabla 1 – Código de Resultado del Servicio

serviceResultCode	Descripción	Código HTTP
0	La ejecución del servicio fue exitosa, el módulo procesó la solicitud correctamente.	200

Código de resultado del servicio /authenticateUser

serviceResultCode	Descripción	Código HTTP
0	Usuario autenticado exitosamente.	200
-100	El parámetro registeredTemplateRaw no coincide con el ID: [XXX]	200
-101	El parámetro bestImageToken no coincide con una persona real (prueba de vida).	200
-102	La autenticación del usuario falló debido a que la templateRaw no coincide.	200

Código de resultado del servicio /updateUserTemplate

serviceResultCode	Descripción	Código HTTP
0	La templateRaw del usuario se actualizó exitosamente.	200
-100	El parámetro registeredTemplateRaw no coincide con el ID: [XXX]	401
-102	El parámetro registeredTemplateRaw enviado no coincide con la templateRaw del usuario registrado para el ID de usuario: [XXX]. InvalidRegisteredTemplateRaw.	401
-103	Usuario no encontrado	400

Tabla 2 – Resultado de autenticación facial del servicio

Código	Resultado	Descripción
0	NONE	No se pudo realizar la verificación facial.
1	NEGATIVE	El proceso se ejecutó exitosamente. La comparación de patrones faciales de los rostros no coincide.
3	POSITIVE	El proceso se ejecutó exitosamente. La comparación de patrones faciales de los rostros es positiva. El valor de serviceFacialSimilarityResult indica el % de similitud entre las imágenes comparadas.
4	NONE BECAUSE POSE EXCEED	No se pudo realizar la verificación facial debido a la pose del rostro.
5	NONE BECAUSE INVALID EXTRACTIONS	No se pudo realizar la verificación facial debido a problemas en la extracción del patrón facial.

Tabla 3 – Resultado de prueba de vida del servicio (Service Liveness Result)

Código	Resultado	Descripción
0	None	No se pudo evaluar la prueba de vida.
1	Spoof	OBSOLETO. Utilizar 'NoLive' en su lugar.
2	Uncertain	OBSOLETO
3	Live	Se presume que el sujeto está vivo.
4	NoneBecauseBadQuality	No se pudo evaluar la prueba de vida debido a la mala calidad de la imagen.
5	NoneBecauseFaceTooClose	No se pudo evaluar la prueba de vida porque se detectaron rostros demasiado cerca de los bordes.
6	NoneBecauseFaceNotFound	No se pudo evaluar la prueba de vida porque no se detectaron rostros.
7	NoneBecauseFaceTooSmall	No se pudo evaluar la prueba de vida porque los rostros detectados eran demasiado pequeños.
8	NoneBecauseAngleTooLarge	No se pudo evaluar la prueba de vida porque el ángulo entre rostros excedió el límite permitido.
9	NoneBecauseImageDataError	No se pudo evaluar la prueba de vida debido a errores en el formato de la imagen.
10	NoneBecauseInternalError	No se pudo evaluar la prueba de vida debido a un error interno.
11	NoneBecauseImagePreprocessError	No se pudo evaluar la prueba de vida debido a un error en el preprocesamiento de la imagen.
12	NoneBecauseTooManyFaces	No se pudo evaluar la prueba de vida porque se detectaron demasiados rostros en la imagen.
13	NoneBecauseFaceTooCloseToBorder	No se pudo evaluar la prueba de vida porque el rostro está demasiado cerca del borde.
14	NoneBecauseFaceCropped	No se pudo evaluar la prueba de vida porque el rostro está recortado.
15	NoneBecauseLicenseError	No se pudo evaluar la prueba de vida debido a un error de licencia.
16	NoneBecauseFaceOccluded	No se pudo evaluar la prueba de vida porque el rostro está ocluido.
17	NoLive	No se detectó vida (prueba de vida fallida).
18	NoneBecauseEyesClosed	No se pudo evaluar la prueba de vida porque los ojos de la persona están cerrados.

---

Escenarios de error y respuestas

Precaución Para los casos de errores de validación de parámetros de entrada, se obtendrá una respuesta de acuerdo con RFC 9457 Problem Details (Detalles del problema).

Ejemplo de escenario	Código HTTP	Content-Type	Cuerpo (Body)
Parámetro requerido faltante	400	application/json	json<br>{<br> "status": 400,<br> "title": "Bad Request",<br> "detail": "Solicitud no válida.",<br> "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",<br> "errors": [<br> "countryCode es requerido"<br> ]<br>}
Fallo de comunicación con servicio externo	502	application/json	json<br>{<br> "status": 502,<br> "title": "Bad Gateway",<br> "detail": "El servidor obtuvo una respuesta no válida.",<br> "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"<br>}
Tiempo de espera agotado (Timeout)	504	application/json	json<br>{<br> "message": "La solicitud al endpoint agotó el tiempo de espera"<br>}