FAfacephi
IAD

Evaluar liveness

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.

post/api/v1/iad/liveness/evaluate

Request

Request body multipart/form-data

capturestring binary required

Buffer de datos binarios, típicamente datos de captura biométrica (imágenes, fotogramas de vídeo, etc.).

Response

Resultado público de liveness

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.
probabilitynumber float
scorenumber float
faceProbabilitynumber float
sdkDurationinteger
queueDurationinteger

Changes

No recorded changes to this operation across all 1 revision of this API.