---
title: "Evaluar liveness"
method: POST
path: "/api/v1/iad/liveness/evaluate"
tags: ["IAD"]
---

# Evaluar liveness

`POST /api/v1/iad/liveness/evaluate`

Verifica el liveness en una captura biométrica cifrada y expone un resultado público de Facephi.
El nombre del campo de la solicitud multipart debe ser `capture`; el campo heredado `file` no se acepta.

Las respuestas correctas HTTP 200 devuelven los campos públicos `diagnostic`, `reason`, `probability`, `score`,
`sdkDuration` y `queueDuration`.

Si la mitigación experimental de ataques de repetición está habilitada en el momento del despliegue, las capturas más antiguas que la
vigencia configurada se rechazan con HTTP 400 y el mensaje `Replay attack detected`.

## Response `200`

Resultado público de liveness

- CaptureLivenessResult — Respuesta pública de liveness expuesta por la API de Facephi.
  - `diagnostic` 'Live' | 'NoLive'
  - `reason` 'None' | 'Unknown' | 'UntrustedEnvironment' | 'SuspiciousActivity' | 'UntrustedDevice' | 'SdkIntegrityViolation' | 'UntrustedCorruptedPayload' | 'UntrustedContent' | 'UntrustedContentLowConfidence' — Motivo público de liveness. Valores posibles: - `None`: la captura fue aceptada como `Live`. - `Unknown`: el servicio no pudo asignar la respuesta a un motivo de rechazo público documentado. - `UntrustedEnvironment`: el entorno de ejecución no se considera de confianza. - `SuspiciousActivity`: el dispositivo mostró patrones de actividad asociados a un ataque. - `UntrustedDevice`: no se pudo confiar en que el dispositivo fuera el que dice ser. - `SdkIntegrityViolation`: el SDK de captura o sus librerías parecen haber sido alterados. - `UntrustedCorruptedPayload`: el payload parece estar corrupto o manipulado. - `UntrustedContent`: se detectó un ataque de inyección. - `UntrustedContentLowConfidence`: se detectaron indicios de un ataque de inyección con menor confianza y la captura debe tratarse igualmente como rechazada.
  - `probability` number, float
  - `score` number, float
  - `faceProbability` number, float
  - `sdkDuration` integer
  - `queueDuration` integer

## Other responses

- `400` — Error de validación de la solicitud o de validación de vigencia de la captura. Los errores de validación de captura se normalizan en el campo público `message`.
- `500` — Se ha producido un error en el backend.

---

[API](https://skmtc.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)