Face Liveness

Servicio que determina si la selfie corresponde a una persona presente en el momento de la captura.

Endpoint

POST /biometric/face/liveness

Headers

Nombre	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de consumer en formato Bearer <token>. Ver Autenticación.
consumer-id	string	Sí	Identificador del consumer.
operation-id	string	Condicional	Identificador de la operación a la que pertenecen los assets referenciados. Requerido cuando source es FILE_KEY. Ver Storage.

Cuerpo de la solicitud

Content-Type: application/json

Parámetros

Parámetro	Tipo	Requerido	Descripción
source	string	Sí	Modo en que se aportan los assets: FILE_KEY para claves de assets almacenados, FILE para contenido en Base64. Ver Storage.
image	string	Sí	Selfie: clave del asset TOKEN_BEST_IMAGE o su contenido en Base64.

Ejemplo de solicitud

{
  "source": "FILE_KEY",
  "image": "0192a3f4-7b21-7c44-9e1a-3f5b8c2d1e04/TOKEN_BEST_IMAGE"
}

Respuestas

200 Éxito

Parámetros de respuesta

Parámetro	Tipo	Descripción
consumerId	string	Identificador del consumer que realizó la llamada.
transactionId	string	Identificador de la transacción.
timestamp	string	Marca de tiempo de la respuesta en formato ISO 8601.
message	string	Campo descriptivo del resultado de la ejecución del servicio.
livenessResult	string	Resultado de la prueba de vida: LIVE, NO_LIVE o ERROR.

Ejemplo de respuesta

{
  "consumerId": "consumer-web",
  "transactionId": "a29cbe15-2b68-495f-b7eb-be985b21c486",
  "timestamp": "2026-06-26T12:00:05.000Z",
  "message": "Service executed ok",
  "livenessResult": "LIVE"
}

Otras respuestas

Código	Descripción
400	Campo obligatorio ausente o valor no admitido; falta la cabecera operation-id habiendo referencias; o una clave no tiene la forma {operationId}/{CONTEXTO} o declara un contexto que el hueco no admite.
403	El consumer no está aprovisionado con el servicio LIVENESS.
404	La operación declarada en operation-id no existe o pertenece a otro consumer.
409	Un asset referenciado contiene un contenido ya procesado en otra operación.
410	La operación declarada en operation-id ha caducado.
422	Una clave nombra una operación distinta de la declarada en operation-id, o el contexto no tiene ningún asset almacenado.
429	El consumer ha superado su límite de tasa de peticiones, o un asset referenciado ha agotado su presupuesto de invocaciones en este endpoint. En el primer caso la respuesta incluye Retry-After, X-RateLimit-Limit y X-RateLimit-Burst, y esperar resuelve; en el segundo no. El servicio subyacente no se invoca y la llamada no se factura.

El cuerpo de una respuesta de error tiene la forma descrita en Middleware API v2.