MOST Docs
Liveness Detection [application/json]
POST/liveness/detectRequest
Token de autorização obtido no método Authentication/Authenticate JWT. Ver especificação da rota Authenticate (Get JWT)
🔸Requerido quando o parâmetro fileUrl não é informado. Binário do arquivo a ser processado, codificado em string de texto conforme o padrão RFC 4648, usando a codificação base64.
🔸Requerido quando o parâmetro file não é informado. Url pública do arquivo a ser processado.
Movimentos da pessoa a serem validados. Pode-se especificar mais de um, sendo: 'up' virar rosto para cima, 'down' virar rosto para baixo, 'left' virar rosto para esquerda, 'right' virar rosto para direita, 'smile' valida se o usuário fez um sorriso e 'blink' valida se o usuário piscou com os dois olhos. Este campo deve ser vazio no caso de detecção de vida passiva.
Booleano indicando se a imagem retornada será fullSize (true) ou imagem com tamanho reduzido (false).
Esse parâmetro será falso se não for inserido ou se atribuído false.
{
"fileBase64": "",
"fileUrl": "",
"movements": [
"up",
"left",
"down",
"right",
"smile"
],
"returnFullFace": "true"
}Request samples
Responses
Lista contendo o resultado do método.
Ponto flutuante contendo o score que representa a avaliação global do Liveness, agregando informações dos movimentos feitos pelo usuário (incluindo penalidades para movimentos não requisitados) e também sobre a veracidade da prova de vida realizada. Seu valor vai de 0 a 1 e, caso o usuário tenha realizado todos os movimentos requisitados pelo Liveness e seja uma pessoa viva, sempre assumirá valores acima de 0.5, caso contrário, apresentará valores abaixo deste limiar. Se os movimentos requisitados forem nulos (detecção de vida passiva), este score agregará apenas a informação sobre a prova de vida, sendo igual ao livenessScore.
Ponto flutuante contendo o score que representa o total de movimentos encontrados temporalmente pelo Liveness com relação ao que foi requisitado para o usuário, considerando a ordem e incluindo penalidades para movimentos não requisitados. Seu valor pode variar de 0 a 1 e será igual a 0 no caso de prova de vida passiva.
Ponto flutuante contendo o score que representa a avaliação do Liveness no que diz respeito à veracidade da prova de vida realizada pelo usuário. Seu valor vai de 0 a 1 e, em casos de detecção de fraude, será retornado o valor menor que 0.5.
Ponto flutuante contendo o score que representa a qualidade da frontalImage retornada. Seu valor varia de 0 a 1 e quanto mais próximo de 1, mais adequada a imagem é para um possível cadastro. É considerado que uma imagem ótima para cadastro possui a face frontal e centralizada, os olhos abertos e uma boa qualidade geral da imagem, incluindo boa iluminação, contraste, entre outros. Caso não seja retornado uma frontalImage, o imageScore retornado será 0. Recomenda-se considerar que uma imagem adequada para cadastro possui imageScore acima de 0.7, porém esse valor pode ser modificado para atender melhor as necessidades de cada cliente.
Arquivo binário com a imagem frontal do indivíduo. A imagem é codificada em string de texto conforme o padrão RFC3548 usando a codificação base64.
Código único de identificação da solicitação ao servidor, que será registrado no histórico de consumo dos serviços.
Tempo de duração do processamento em milissegundos.
Objeto contendo o código de status e a mensagem de resposta.
Código de status interno. Veja os valores possíveis nas mensagens de erro do mostQI.
Mensagem de retorno de status. Veja os valores possíveis nas mensagens de erro do mostQI.
{
"result": {
"globalScore": 1,
"movementScore": 1,
"livenessScore": 1,
"imageScore": 1,
"frontalImage": "base64"
},
"requestId": "xxxxxxxxxxxxxxxxxxxxx",
"elapsedMilliseconds": 1000,
"status": {
"message": "Success",
"code": "S100",
"errors": null
}
}