Facematch

Este artigo explica como verificar a autenticidade da foto em um documento 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

Nome	Tipo	Mandatorio/Opcional	Descrição
APIKEY	String	Mandatório	API key
Authorization	String	Mandatório	Token de acesso
Content-Type	String	Mandatório	"application/json"

• REQUEST BODY SCHEMA

Nome	Tipo	Mandatorio/Opcional	Descrição
Base64Selfie	String	Mandatório	Selfie da pessoa. A imagem precisa ser em base64 (png, jpg, jpeg)
Base64Documento	String	Mandatório	Foto 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.