Liveness Streaming Status [application/json]

Esta rota permite consultar o status do processo de prova de vida solicitada na rota Liveness Streaming [application/json].

O status de um processo pode ser consultado por 1 hora após a requisição inicial, assegurando um tempo suficiente para monitoramento e retorno dos dados.

Status e descrições possíveis:

Status	statusDescription	Detalhe
TODO	"Waiting for user interaction"	A prova de vida ainda não foi iniciada ou está em andamento.
DOING	"User interaction in progress"	A sessão de prova de vida foi iniciada, ou seja, o usuário clicou em "Iniciar captura" e o processo está em andamento.
DONE	"User interaction completed successfully"	A prova de vida foi concluída. Nesse caso, o resultado incluirá valores para os atributos frontalImage e livenessScore, se disponíveis, que devem ser avaliados para a definição do resultado final da prova de vida.
EXPIRED	"User did not interact within the time limit"	A sessão de prova de vida expirou. Isso ocorre quando o usuário não conclui a prova de vida dentro do prazo de 3 minutos após clicar em "Iniciar captura".
CANCELED	"Canceled after 1 hour of inactivity"	A sessão de prova de vida foi cancelada por não ser concluída dentro do tempo máximo de 1 hora.
ERROR	"Camera access error"	Não foi possível acessar a câmera do dispositivo. Verifique se a permissão de uso da câmera está habilitada no navegador ou nas configurações do aparelho.
ERROR	"Camera framerate error"	A câmera não está conseguindo capturar imagens com a taxa mínima necessária.
ERROR	"Default camera not found"	Nenhuma câmera foi encontrada no dispositivo. Verifique se o equipamento possui câmera disponível e se ela está funcionando corretamente.
ERROR	"Liveness session has expired. Please create a new session."	A sessão de verificação expirou. Por favor, inicie uma nova sessão para continuar o processo.
ERROR	"Face distance error"	O rosto está muito próximo ou muito distante da câmera. Ajuste a posição do dispositivo até que seu rosto fique bem enquadrado na tela.
ERROR	"The security token included in the request is invalid."	O token de segurança da requisição é inválido ou expirou.
ERROR	"Server and device clocks are out of sync"	O horário do dispositivo está diferente do horário do servidor. Verifique se a data e hora do aparelho estão configuradas corretamente.
ERROR	"Device orientation error"	A orientação do dispositivo está incorreta. Posicione o celular na orientação indicada na tela para continuar.
ERROR	"Multiple faces error"	Foram detectados vários rostos na câmera. Certifique-se de que apenas uma pessoa esteja visível no enquadramento.
ERROR	"Liveness session has results available. Please get results for the session."	Esta sessão de verificação já possui resultados disponíveis. Utilize a consulta de resultados para obter as informações da sessão.
ERROR	"Unexpected runtime error"	Ocorreu um erro inesperado durante a execução do processo. Tente novamente em alguns instantes.
ERROR	"Unexpected server error"	Ocorreu um erro inesperado no servidor. Tente novamente mais tarde.
ERROR	"Connection timed out"	O tempo de conexão foi excedido. Verifique sua conexão com a internet e tente novamente.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Ok

application/json

Body

{
    "result": {
        "processId": "dbf9e398-98de-41d3-8b95-525026c00f96",
        "status": "TODO",
        "statusDescription": "Waiting for user interaction",
        "livenessScore": null,
        "frontalImage": null
    },
    "requestId": "aeYmNfTUBs2zhWOB4to55",
    "elapsedMilliseconds": 314,
    "status": {
        "message": "Ok",
        "code": "200",
        "errors": null
    }
}

🟠400Invalid authentication data

🟠400R101 A specified parameter is wrong

🟠400R125 Process expired or not found with the given ID