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
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:
{
"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.