Face Match

Recebe foto da face e a foto do documento, então realiza a comparação biométrca.

Requisitos:

  1. A imagem do documento deve ter no mínimo 1000 pixels de largura. Para melhores resultados, é recomendável que possua pelo menos 2000 pixels.
  2. A foto do sujeito deve ter resolução mínima de 250 x 250 pixels.
  3. Somente os formatos JPG e PNG são aceitos no momento.
  4. Tamanho de cada imagem não pode ultrapassar 5MB.

Liveness*:

  • Liveness pode ser usado nessa operação.
  • O uso de liveness, por padrão, é definido pela aplicação, mas pode ser sobrescrito em cada chamada com parâmetro 'liveness', que aceita valores booleanos, presente no corpo da requisição.
  • O teste de liveness pode ser realizado à partir de uma foto ou de uma evidência de liveness.
  • A foto deve ser enviada no campo 'selfie'. A evidência deve ser enviada no campo 'liveness_evidence'.
  • Caso opte por usar a evidência de livensess, a foto usada na operação será extraída da mesma.
  • Retorna o resultado do liveness na mensagem de resposta: 'liveness_result'.

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 reprovação no teste de liveness, a operação é anulada e o retorno é a seguinte mensagem:

{

"message": "As imagens capturadas falharam no teste de liveness.",

"error_code": 4007

}

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

messageerror_codeStatus HTTP
Nenhuma face detectada na imagem.9006422
A face está apenas parcialmente dentro da imagem.9007422
A face está parcialmente coberta por um objeto.9008422
Mais de uma face visível na imagem.9009422
O ângulo da face correspondete ao ponto de vista da câmera é largo demais.9010422
Face pequena. A face deve estar mais próxima da câmera.9011422
Face pequena. A face deve estar mais próxima da câmera.9012422
A face está muito próxima da borda, centralize a face na imagem.9013422
A face está muito próxima da câmera.9014422
Face com olhos fechados.9016422
Falha ao obter resultado de liveness.9017500

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
file
required

FOTO DA SELFIE

file
required

FOTO DO DOCUMENTO

file
required

EVIDÊNCIA DE LIVENESS

boolean

Sobreescreve o que foi definido pela aplicação, ativando/desativando liveness para essa chamada específica.

boolean
Defaults to false

Valida a autenticidade do PDF em doc_image.

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json