Extracción facial

/extractFacial

Servicio que realiza la detección y validación facial a partir de una imagen abierta o tokenizada.

Solicitud:

bash

curl --location '{IDENTITY_API_BASE_URL}/services/extractFacial' \
--header 'x-api-key: {API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
  "tokenBuffer": "{TOKEN_BUFFER}"
}'

Parámetros de la solicitud:

Parámetro	Tipo (Contenido)	Requerido	Descripción
tokenBuffer	String (Base64)	Sí	Imagen codificada en Base64 o tokenizada para la detección facial.

Ejemplo de respuesta:

json

{
    "serviceResultCode": 0,
    "serviceResultLog": "Solicitud de servicio procesada correctamente",
    "serviceTime": "864",
    "serviceFacialExtractionResult": "{\"faceConfidence\":0.9999948143959045,\"age\":30,\"glasses\":\"None\",\"gender\":\"Male\",\"iod\":154}",
    "serviceTransactionId": "b2f6297b-01ca-4aa3-afd7-6cb3c9d74141"
}

Campos de la respuesta:

Identificador	Tipo	Descripción
serviceResultCode	Integer	Código que indica el resultado general de la ejecución del servicio.
serviceResultLog	String	Campo descriptivo del resultado o mensaje de error, si corresponde.
serviceTime	String	Tiempo de procesamiento de la solicitud.
serviceTransactionId	String	ID de transacción asociado a la solicitud procesada por la API.
serviceFacialExtractionResult	JSON	Objeto que representa la detección y validación facial.
↳ age	Integer	Indica la posible edad detectada.
↳ glasses	String	Indica la detección de gafas. Valores posibles: Eye (Gafas de vista), None (Ninguna), Sun (Gafas de sol)
↳ gender	String	Devuelve el género detectado. Valores posibles: Male (Masculino), Female (Femenino), None (No determinado)
↳ iod	Integer	Indica la distancia interpupilar.
↳ faceConfidence	Float	Indica el nivel de confianza del rostro evaluado.

Precaución Tenga en cuenta que todos los valores devueltos son estimaciones basadas en la imagen facial proporcionada. La precisión y confiabilidad real pueden variar dependiendo de la calidad y las características de la imagen de entrada.