Validación biométrica

Descripción del producto #

Este servicio realiza detección y comparación de rostros para validar identidades biométricamente. Incluye detección de rostros en imágenes y comparación de similitud entre selfies y fotos de registro (e.g., de documentos). Útil para antifraude en KYC, con validaciones como coincidencia facial y estimación de edad/género.

Requisitos de autenticación #

• Método: HTTP Basic (concatenar client_id:client_secret, codificar en Base64).
• Header: Authorization: Basic <base64_string>.
• Nota: Las credenciales (client_id y client_secret) deben solicitarse al equipo de S.O.F.I.A. para pruebas en el entorno de sandbox. Estas serán proporcionadas una vez que el cliente esté inscrito.

Endpoints #

• Detección de rostro: POST https://qa.bio.credit/api/detecting-face (Sandbox).
• Comparación de rostros: POST https://qa.bio.credit/api/compare-faces (Sandbox).

Headers #

Key	Value	Description
Accept	application/json	Formato de respuesta esperado.
Content-Type	application/json	Formato del body (multipart/form-data implícito para archivos).
Authorization	Basic [Base64]	Credenciales de autenticación.
country	COL	Código de país (opcional, e.g., para Colombia).

Parámetros de entrada (body) #

Usa multipart/form-data para subir archivos.

Para detección de rostro: #

Key	Type	Required	Description
user_face	file	Sí	Imagen con el rostro a detectar.

Ejemplo JSON Request (simulado, ya que es form-data):

{
  "user_face": "ruta/a/imagen.png"
}
        

Para comparación de rostros: #

Key	Type	Required	Description
face_selfie	file	Sí	Imagen selfie del usuario.
face_register	file	Sí	Imagen de referencia (e.g., de documento).

Ejemplo JSON Request (simulado):

{
  "face_selfie": "ruta/a/selfie.png",
  "face_register": "ruta/a/registro.png"
}
        

Parámetros de salida (respuesta) #

Para detección de rostro: #

Key	Type	Description
face_detected	boolean	Indica si se detectó un rostro.

Ejemplo JSON Response (éxito):

{
  "face_detected": true
}
        

Para comparación de rostros: #

Key	Type	Description
face_matches	boolean	Indica si los rostros coinciden.
similarity	float	Porcentaje de similitud (0-100).

Ejemplo JSON Response (éxito):

{
  "face_matches": true,
  "similarity": 99.95965576171875
}
        

Manejo de errores #

HTTP Code	Error Code	Description
400	WHK001	No se enviaron archivos o no se detectó rostro (e.g., {“error”: “La imagen face_register no contiene un rostro”}).
401	WHK002	Autenticación fallida.

Notas adicionales #

• Integrado con lectura de documentos (scores como 75-95%).
• Limites de tasa: Condiciones del contrato.
• Pruebe en sandbox para validar similitud; umbral recomendado >80% para coincidencia.