Autenticación facial
/authenticateFacial
Este servicio realiza la validación facial entre dos rostros, incluyendo tanto imágenes abiertas como plantillas biométricas. El servicio puede utilizarse para las siguientes validaciones:
Autenticación facial entre dos imágenes abiertas:
Generadas o no por widgets de FacePhi.
Autenticación facial entre dos plantillas biométricas:
Requiere integración del widget FacePhi Selphi Mobile o Web.
Autenticación facial entre una imagen abierta y una plantilla biométrica:
Requiere integración del widget FacePhi Selphi Mobile o Web.
Autenticación facial entre el rostro presente en la foto del documento de identidad (
TokenFaceImage) y una imagen abierta:Requiere integración del widget FacePhi SelphID Mobile.
Autenticación facial entre el rostro presente en la foto del documento de identidad (
TokenFaceImage) y una plantilla biométrica:Requiere integración de los widgets FacePhi Selphi Mobile y SelphID Mobile.
Solicitud:
bash
curl --location '{IDENTITY_API_BASE_URL}/services/authenticateFacial' \
--header 'x-api-key: {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
"token1": "BASE64_IMAGE_OR_TOKEN",
"token2": "BASE64_IMAGE_OR_TOKEN",
"method": 1,
"tracking": {
"extraData": "BQABAQG2gBNjuHN...",
"operationId": "xxxxx-xxxxx-xxxxx-xxxxx-xxxxx"
}
}'Parámetros de la solicitud:
Parámetro
Tipo (Contenido)
Requerido
Descripción
token1
String (Base64)
Sí
Imagen utilizada como referencia para la comparación facial. Dependiendo del método invocado, puede ser el token generado por los widgets SelphID (token de la foto del documento), una imagen abierta o una plantilla biométrica tokenizada.
token2
String (Base64)
Sí
Imagen utilizada para la comparación. Puede ser una imagen abierta o una plantilla biométrica tokenizada.
method
Integer
Sí
Indica el método de comparación invocado según la siguiente especificación (métodos 1 a 5):
tracking
JSON Object
No
Objeto que representa la información de seguimiento necesaria.
extraData
String (Base64)
No
Token generado por el SDK móvil/web. Contiene información de seguimiento tokenizada con la Plataforma.
operationId
String (Base64)
No
Identificador de operación generado por el SDK móvil/web.
Especificación del método
Método
Descripción
Método = 1
Autenticación facial utilizando imágenes abiertas (token1: Base64, token2: Base64)
Método = 2
Autenticación facial utilizando plantillas biométricas (token1: templateRaw, token2: templateRaw)
Método = 3
Autenticación facial utilizando una imagen abierta y una plantilla biométrica (token1: Base64, token2: templateRaw)
Método = 4
Autenticación facial utilizando el token generado por el recorte de la foto del documento y una imagen abierta (token1: tokenFaceImage, token2: Base64)
Método = 5
Autenticación facial utilizando el token generado por el recorte de la foto del documento y una plantilla biométrica (token1: tokenFaceImage, token2: templateRaw)
Ejemplo de respuesta
json
Campos de la respuesta:
Identificador
Tipo
Descripción
serviceResultCode
Integer
Código que indica el resultado general de la ejecución del servicio. Ver Tabla 1 - Código de Resultado del Servicio
serviceTime
String
Tiempo total de procesamiento (milisegundos).
serviceFacialAuthenticationResult
Integer
Código que indica el resultado de la coincidencia facial. Ver Tabla 2 - Resultado de Autenticación Facial del Servicio
serviceResultLog
String
Campo descriptivo del resultado de la ejecución del servicio. Incluye detalles cuando hay un error o excepción en el módulo.
serviceFacialSimilarityResult
Float
Valor que indica la similitud facial entre el rostro en la foto del documento de identidad y la selfie tomada por el usuario. 1.0 = 100%
serviceTransactionId
String
Identificador de transacción asociado a la solicitud procesada por la API.
serviceFacialAuthenticationHash
String
Hash de integridad de la plantilla biométrica utilizada en una autenticación facial positiva o incierta. Solo aplica en los métodos 2, 3 y 5.
Last updated