---
title: "POST /api/v1/selphid/passive-liveness/evaluate/token"
method: POST
path: "/api/v1/selphid/passive-liveness/evaluate/token"
tags: ["Passive Liveness"]
---

# POST /api/v1/selphid/passive-liveness/evaluate/token

`POST /api/v1/selphid/passive-liveness/evaluate/token`

Evalúa la prueba de vida pasiva de una imagen tokenizada.

## Request body

- PassiveLivenessToken — Una imagen tokenizada, utilizada para la prueba de vida pasiva. Además, admite _extraData_, para el registro en Api Tracking.
  - `tokenImage` string, required — Imagen tokenizada, codificada en base64.
  - `extraData` string — Datos tokenizados para invocar al servicio Api Tracking tras la operación, codificados en base64.
  - `options` SdkOptions — Opciones para personalizar el uso de los motores de extracción e identificación. Su uso es opcional y ninguna opción es obligatoria. Si se omiten, se usarán los valores por defecto.
    - `longDetail` boolean — Si es true, el resultado del endpoint incluirá información adicional. Si se omite, el valor por defecto será false.
    - `elapsedAllowedSeconds` integer — Tiempo de vida máximo de un templateRaw (en segundos) para considerarse válido en operaciones de autenticación o prueba de vida. Si es 0 (por defecto), no hay límite.
    - `futureAllowedSeconds` integer — Tiempo de vida futuro máximo de un templateRaw (en segundos) para considerarse válido en operaciones de autenticación o prueba de vida. La plantilla puede haberse creado en un dispositivo con una fecha futura respecto al dispositivo que la consume. Si es 0 (por defecto), no se aceptará ningún templateRaw con una fecha futura.
    - `facialDetection` 'Frontal' | 'FrontalFast' — Tipos de detección facial en el motor de extracción.
    - `minFaceAbsPx` integer — Tamaño mínimo en píxeles que debe tener un rostro para ser detectado.
    - `minFaceRel` number — Tamaño mínimo, en proporción al tamaño de la imagen, que debe tener un rostro para ser detectado.
    - `minIodPx` integer — Distancia interocular mínima en píxeles que debe tener un rostro para ser detectado.
    - `maxPoseDegrees` number — Diferencia máxima de ángulo (en grados) entre dos poses para considerarse válida en procesos de autenticación.
    - `minFacialQuality` 'None' | 'Bad' | 'Regular' | 'Good' — Una métrica que indica con qué precisión se comportará una plantilla en el reconocimiento.
    - `analyticsDetection` boolean — Obtiene analíticas adicionales en el motor de extracción.
    - `templateRawExtraction` boolean — El motor de extracción generará la plantilla en bruto.
    - `falseDetectRate` number — Nivel de tolerancia de falso rechazo en el motor de extracción. No se recomienda usar este valor si no está seguro de sus efectos.
    - `maxCantidates` integer — El número máximo de candidatos que se desean en la respuesta.
    - `minSimilarity` number — La similitud mínima requerida para que un candidato se incluya en la respuesta.
    - `authThreshold` number — Valor mínimo en una autenticación para considerarla positiva.
    - `livenessDepth` 'None' | 'Partial' | 'Full' — Qué pipelines de prueba de vida deben utilizarse.

## Response `200`

Resultado de la prueba de vida pasiva.

- PassiveLivenessResult — El resultado de una operación de prueba de vida pasiva.
  - `diagnostic` 'None' | 'Spoof' | 'Uncertain' | 'Live' | 'NoneBecauseBadQuality' | 'NoneBecauseFaceTooClose' | 'NoneBecauseFaceNotFound' | 'NoneBecauseFaceTooSmall' | 'NoneBecauseAngleTooLarge' | 'NoneBecauseImageDataError' | 'NoneBecauseInternalError' | 'NoneBecauseImagePreprocessError' | 'NoneBecauseTooManyFaces' | 'NoneBecauseFaceTooCloseToBorder' | 'NoneBecauseFaceCropped' | 'NoneBecauseLicenseError' | 'NoneBecauseFaceOccluded' | 'NoLive' | 'NoneBecauseEyesClosed' | 'NoneBecauseEyesOccluded' | 'NoneBecauseTokenDataError' | 'NoneBecauseTokenSecurity' — Posibles resultados de una operación de prueba de vida.
  - `noLiveDetails` NoLiveDetails — Detalles para el caso FacialLivenessDiagnostic::NoLive
    - `mainCause` 'FPadFailed' | 'FMadFailed' | 'MultipleFailed' | 'Unknown' — Causa principal de alto nivel del diagnóstico NoLive.
    - `fPadStatus` 'NotEvaluated' | 'Passed' | 'Failed' | 'Error' — Estado de la detección facial de ataques de presentación (fPAD).
    - `fPadScore` number — Puntuación fPAD normalizada, si está disponible
    - `fMadStatus` 'NotEvaluated' | 'Passed' | 'Failed' | 'Error' — Estado de la detección facial de ataques de manipulación (fMAD).
    - `fMadScore` number — Puntuación fMAD normalizada, si está disponible
    - `coercionScore` number — Puntuación de coerción normalizada, si está disponible
    - `reasonMessage` string — Mensaje del motivo legible por humanos, para registros/backoffice.
  - `validTimeStamp` boolean — En las operaciones de autenticación, prueba de vida y extracción que implican templateRaws, indica si el tiempo de vida de la plantilla es válido. Véase "options:elapsedAllowedSeconds". En las operaciones que no implican plantillas en bruto, siempre será true.
  - `tokenTimeStamp` string — El valor interno de fecha y hora del token en formato "%Y-%m-%dT%H:%M:%SZ".
  - `trackingStatus` number — Estado devuelto por el servicio Api Tracking, o -1 si no se requiere tracking.
  - `trackingMessage` string — Mensaje devuelto por el servicio Api Tracking, o vacío si no se requiere tracking.
  - `sdkDuration` number — Duración de la operación en milisegundos.

## Other responses

- `400` — Parámetros incorrectos en la solicitud.
- `500` — Se ha producido un error en la llamada al backend de SelphID-SDK.

---

[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)