Pular para o conteúdo principal

Obter informações do processo de Biometria

Este artigo explica como obter informações de um processo de biometria em aberto através da REST API do Unico Check.

Como usar?

Faça uma requisição GET para o endpoint /processes/{processoId}

Com o token de acesso válido, faça uma requisição para o endpoint (GET/processes/{processoId}).

Parametros:

  • HEADER PARAMETERS
NomeTipoMandatorio/OpcionalDescrição
APIKEYStringMandatórioAPI key
AuthorizationStringMandatórioToken de acesso
  • PATH PARAMETERS
NomeTipoMandatorio/OpcionalDescrição
processoIdStringMandatórioNumero do processo

Requisição com Sucesso

Se a requisição foi executada com sucesso, a resposta de retorno é um JSON contendo os seguintes parâmetros:

{
"HasBiometry": true,
"Id": "11111111-1111-1111-1111-111111111111",
"Liveness": 0,
"Score": 95,
"Status": 3,
"OCRCode": 0,
"FaceMatch": 0
}

Os parâmetros de retorno são:

NomeTipoDescrição
HasBiometrybooleanIndica se o processo possui uma foto biometricamente válida ou não (se possui um rosto ou não).
IdstringIndica o ID do processo criado com o envio da foto. Ele é utilizado nos outros métodos de 'Processes'
LivenessintegerIndica o status do liveness, indica se é uma foto de foto ou não. 0 - Desligado // 1 - Foto OK // 2 - Foto de Foto
ScoreintegerIndica o score de autenticação daquele CPF / Foto. Ver a sessão de Score para entender melhor sobre
StatusintegerIndica o status do Processo, usado para indicar se está concluído ou não.
OCRCodeintegerIndica o status do OCRCode, procura no documento informado um determinado CPF. 0 - Desligado // 1 - Ok // 2 - Não Ok
FaceMatchintegerIndica o status do FaceMatch, verifica se a foto no documento é a mesma pessoa da foto informada. 0 - Desligado // 1 - Ok // 2 - Não Ok

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.