---
title: "Liveness Validation"
method: POST
path: "/api/v2/liveness"
tags: ["Liveness"]
---

# Liveness Validation

`POST /api/v2/liveness`

Rota exclusiva para avaliar o liveness de selfies ou evidências de liveness (Blob).

**Importante:** Os campos 'selfie' e 'liveness_evidence' são mutualmente exclusivos, ou seja: Não devem ser eviados juntos na mesma requisição.

Em caso de sucesso, ou seja, quando selfie/evidência são aprovadas no teste de liveness, o retorno é uma resposta com status code: 200.

Caso ocorra uma reprovação no teste de liveness, o retorno é a seguinte mensagem:

`{ "message": { "description": "A imagem capturada falhou no teste de liveness.", "error_fields": { "liveness_evidence": [ { "bodyPart": "FACE", "format": "JPG", "livenessResult": { "face_liveness": { "probability": 0.5516739 }, "capture_liveness": { "score": 0.5102542, "probability": 0 } } } ] } }, "error_code": 4007 }`

Caso ocorra um problema para realizar o teste de liveness, a API irá retornar um dos seguintes erros:

| message | **error_code** | Status HTTP |
| --- | --- | --- |
| Nenhuma face detectada na imagem. | 9006 | 422 |
| A face está apenas parcialmente dentro da imagem. | 9007 | 422 |
| A face está parcialmente coberta por um objeto. | 9008 | 422 |
| Mais de uma face visível na imagem. | 9009 | 422 |
| O ângulo da face correspondete ao ponto de vista da câmera é largo demais. | 9010 | 422 |
| Face pequena. A face deve estar mais próxima da câmera. | 9011 | 422 |
| Face pequena. A face deve estar mais próxima da câmera. | 9012 | 422 |
| A face está muito próxima da borda, centralize a face na imagem. | 9013 | 422 |
| A face está muito próxima da câmera. | 9014 | 422 |
| Face com olhos fechados. | 9016 | 422 |
| Falha ao obter resultado de liveness. | 9017 | 500 |

Caso o erro com código 9017 persista, deve-se entrar em contato com o administrador do sistema.

Os códigos de erro são os mesmos para qualquer operação feita com liveness ativado.

## Query parameters

- `getImage` boolean
- `getResized` boolean

## Response `200`

- object

## Other responses

- `422`
- `500`
- `x-500:Falha ao obter resultado`
- `x-422:Face parcialmente coberta`

---

[API](https://skmtc.net/bry/apis/bry-easy-sign-api-rest.md) · [All operations](https://skmtc.net/bry/apis/bry-easy-sign-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bry/bry-easy-sign-api-rest/revisions/c87e026e87ac/schema)