Pular para o conteúdo principal

Facematch

Este artigo explica como comparar a foto do documento com a foto capturada através da REST API do Unico Check.

Esse método verifica se a foto no documento informado e a foto enviada na requisição são da mesma pessoa.

Como usar?

Faça uma requisição POST para o endpoint /faces/match

Com o token de acesso válido, faça uma requisição para o endpoint (POST/faces/match) enviando os seguintes parâmetros:

{
"Base64Selfie": "FOTO_PESSOA",
"Base64Documento": "FOTO_DOCUMENTO"
}

Parametros:

  • HEADER PARAMETERS
NomeTipoMandatorio/OpcionalDescrição
APIKEYStringMandatórioAPI key
AuthorizationStringMandatórioToken de acesso
Content-TypeStringMandatório"application/json"
  • REQUEST BODY SCHEMA
NomeTipoMandatorio/OpcionalDescrição
Base64SelfieStringMandatórioSelfie da pessoa. A imagem precisa ser em base64 (png, jpg, jpeg)
Base64DocumentoStringMandatórioFoto do documento. A imagem precisa ser em base64 (png, jpg, jpeg)

Exemplo de requisição:

Arquivo JSON
{
"Base64Selfie": "\"\"iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAgSURBVDhPY/wPBAwUACYoTTYYNWDUABAYNWDgDWBgAABrygQclUTopgAAAABJRU5ErkJggg==\"\"",
"Base64Documento": "\"\"iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAgSURBVDhPY/wPBAwUACYoTTYYNWDUABAYNWDgDWBgAABrygQclUTopgAAAABJRU5ErkJggg==\"\""
}

Requisição com Sucesso

Se a requisição foi executada com sucesso, a resposta de retorno é um JSON contendo o status da verificação como a seguir:

{
"Status": true
}

O status é um boolean indicando se o rosto que está no documento é o mesmo da selfie que foi enviada.

Erro na Requisição

Caso ocorra algum erro, a resposta de retorno é um JSON contendo o código e descrição do erro:

{
"Error": {
"code": "40004",
"description": "Descrição do erro"
}
}

Para mais infomações sobre os erros retornados, consulte a lista disponível no artigo Response Errors.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.