---
title: "POST /api/v1/selphid/custom-event/liveness"
method: POST
path: "/api/v1/selphid/custom-event/liveness"
tags: ["Custom Events"]
---

# POST /api/v1/selphid/custom-event/liveness

`POST /api/v1/selphid/custom-event/liveness`

Envía un evento externo personalizado de prueba de vida a la plataforma Api Tracking.

## Request body

- CustomLiveness — Datos para registrar un evento externo de prueba de vida en la plataforma Api Tracking. Además, admite el búfer de imagen.
  - `family` 'OnBoarding' | 'Authentication', required — Familia con la que registrar los eventos de Api Tracking.
  - `diagnostic` 'None' | 'Spoof' | 'Uncertain' | 'Live' | 'NoneBecauseBadQuality' | 'NoneBecauseFaceTooClose' | 'NoneBecauseFaceNotFound' | 'NoneBecauseFaceTooSmall' | 'NoneBecauseAngleTooLarge' | 'NoneBecauseImageDataError' | 'NoneBecauseInternalError' | 'NoneBecauseImagePreprocessError' | 'NoneBecauseTooManyFaces' | 'NoneBecauseFaceTooCloseToBorder' | 'NoneBecauseFaceCropped' | 'NoneBecauseLicenseError' | 'NoneBecauseFaceOccluded' | 'NoLive' | 'NoneBecauseEyesClosed' | 'NoneBecauseEyesOccluded' | 'NoneBecauseTokenDataError' | 'NoneBecauseTokenSecurity', required — Posibles resultados de una operación de prueba de vida.
  - `eventSource` string — El origen de un evento en el servicio Api Tracking.
  - `image` string — Buffer de imagen en formato JPEG, PNG o BMP, codificado en base64 RFC4648.
  - `extraData` string, required — Datos tokenizados para invocar al servicio Api Tracking tras la operación, codificados en base64.

## Response `200`

Resultado del seguimiento del evento.

- TrackingResult — El resultado de una operación de Api Tracking.
  - `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.

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