> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/selphid/technical_documentation/api_reference/custom-events/api-v1-selphid-custom-event-liveness.md).

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

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

```json
{"openapi":"3.0.0","info":{"title":"SelphID-SDK Rest API","version":"6.21.0"},"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Nombre de la cabecera de la clave de API por defecto. Puede sobrescribirse en el arranque con `auth_api_key_header_name`."}},"schemas":{"CustomLiveness":{"type":"object","description":"Datos para registrar un evento externo de prueba de vida en la plataforma Api Tracking. Además, admite el búfer de imagen.","properties":{"family":{"$ref":"#/components/schemas/TrackingFamily"},"diagnostic":{"$ref":"#/components/schemas/FacialLivenessDiagnostic"},"eventSource":{"$ref":"#/components/schemas/EventSource"},"image":{"$ref":"#/components/schemas/ImageBuffer"},"extraData":{"$ref":"#/components/schemas/ExtraData"}},"required":["family","diagnostic","extraData"]},"TrackingFamily":{"type":"string","description":"Familia con la que registrar los eventos de Api Tracking.","enum":["OnBoarding","Authentication"]},"FacialLivenessDiagnostic":{"type":"string","description":"Posibles resultados de una operación de prueba de vida.","enum":["None","Spoof","Uncertain","Live","NoneBecauseBadQuality","NoneBecauseFaceTooClose","NoneBecauseFaceNotFound","NoneBecauseFaceTooSmall","NoneBecauseAngleTooLarge","NoneBecauseImageDataError","NoneBecauseInternalError","NoneBecauseImagePreprocessError","NoneBecauseTooManyFaces","NoneBecauseFaceTooCloseToBorder","NoneBecauseFaceCropped","NoneBecauseLicenseError","NoneBecauseFaceOccluded","NoLive","NoneBecauseEyesClosed","NoneBecauseEyesOccluded","NoneBecauseTokenDataError","NoneBecauseTokenSecurity"]},"EventSource":{"type":"string","description":"El origen de un evento en el servicio Api Tracking."},"ImageBuffer":{"type":"string","description":"Búfer en bruto de imagen en .png, .jpg o .bmp, codificado en base64."},"ExtraData":{"type":"string","description":"Datos tokenizados para llamar al servicio Api Tracking tras la operación, codificados en base64."},"TrackingResult":{"type":"object","description":"El resultado de una operación de Api Tracking.","properties":{"trackingStatus":{"$ref":"#/components/schemas/TrackingStatus"},"trackingMessage":{"$ref":"#/components/schemas/TrackingMessage"}}},"TrackingStatus":{"type":"number","description":"Estado devuelto por el servicio Api Tracking, o -1 si no se requiere seguimiento."},"TrackingMessage":{"type":"string","description":"Mensaje devuelto por el servicio Api Tracking, o vacío si no se requiere seguimiento."},"BadRequestResult":{"type":"object","description":"Resultado cuando llegan parámetros incorrectos en la solicitud.","properties":{"status":{"type":"number"},"error":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}},"TimeStamp":{"type":"string","description":"Un valor de fecha y hora en formato \"%Y-%m-%dT%H:%M:%SZ\"."},"ExceptionResult":{"type":"object","description":"Se ha producido un error en la llamada al backend de SelphID-SDK.","properties":{"status":{"type":"number"},"error":{"type":"string"},"exception":{"type":"string"},"timeStamp":{"$ref":"#/components/schemas/TimeStamp"}}}}},"paths":{"/api/v1/selphid/custom-event/liveness":{"post":{"description":"Envía un evento externo personalizado de prueba de vida a la plataforma Api Tracking.","tags":["Custom Events"],"requestBody":{"description":"Json con los datos de prueba de vida.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomLiveness"}}}},"responses":{"200":{"description":"Resultado del seguimiento del evento.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackingResult"}}}},"400":{"description":"Parámetros incorrectos en la solicitud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResult"}}}},"500":{"description":"Se ha producido un error en la llamada al backend de SelphID-SDK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExceptionResult"}}}}}}}}}
```