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.