Token Biometrico

Este artigo explica como verificar a autenticidade de um usuário que passou previamente pelo Score de Autenticação (CreateProcess), fornecendo agora uma nova foto a ser comparada com a foto do processo do score de autenticação, utilizando a REST API do Unico Check.

O Token Biométrico é uma funcionalidade do Unico Check para situações em que um usuário que passou previamente pelo Score de Autenticação (CreateProcess) deseja se autenticar, fornecendo uma nova foto

Como usar?

Faça uma requisição POST para o endpoint /biometry/token

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

{
  "processId": "ID_PROCESSO_SCORE",
  "selfie": "FOTO_PESSOA"
}

Parametros:

• HEADER PARAMETERS

Nome	Tipo	Mandatorio/Opcional	Descrição
APIKEY	String	Mandatório	API key
Authorization	String	Mandatório	Token de acesso
X-Tenant	String	Mandatório	Identificador exclusivo da empresa

• REQUEST BODY SCHEMA

Nome	Tipo	Mandatorio/Opcional	Descrição
processId	String	Mandatório	Identificador do processo de score de autenticação (1:N) que será usado como base para comparação com a selfie fornecida
selfie	String	Mandatório	Photo of the person. The image must be in base64 (png, jpg, jpeg). If the photo is captured using the Unico SDK with Liveness, the image sent must be the Json Web Token (.jwt). The .jwt must be sent within 10 minutes to prevent the image from expiring. And this .jwt can only be used once.

Exemplo de requisição:

Arquivo JSON

{
  "processId": "D7A8B471-E69C-42B7-AF14-05E83365A944",
  "selfie": "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:

{
  "authenticated": true
}

O authenticated é um boolean indicando se a foto enviada na requsição é da mesma pessoa que passou pelo score de atenticação.

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.