Biometria facial

Comparação da foto enviada com a foto nas bases oficiais.

Seção: officialData

Parâmetro obrigatório: cpf Arquivos obrigatórios: selfie ou imagem de documento contendo uma foto

Esquema

Atributo	Tipo	Descrição
código	String	Código de resposta
confiança	Número	Porcentagem de semelhança da face do documento com a base oficial
probabilidade	String	Probabilidade de autenticidade da face do documento com a base oficial

Exemplo

{
  "officialData": {
    "código": "01",
    "confidence": 0.9600528478622437,
    "probability": "Altíssima probabilidade"
  }
}

Valores possíveis

código

Código	Descrição
01	Sucesso (comparação realizada). confiança, confidenceStatus e probabilidade são retornados apenas quando código está 01.
02	Atributo obrigatório não informado (ex.: CPF ausente)
03	Imagem/fonte não aplicável ao provedor (ex.: o provedor aceita apenas selfie)
04	Face não encontrada nas bases oficiais do provedor
05	Erro de qualidade/tamanho da imagem ou falha na chamada ("face not found")
06	CPF inválido (validado pelo próprio provedor)
07	Erro genérico / falha na consulta (valor padrão)

probabilidade

Retornado apenas quando código está 01.

Valor (resposta da API)	Descrição
Baixíssima probabilidade	Probabilidade muito baixa
Baixa probabilidade	Baixa probabilidade
Probabilidade média	Probabilidade média
Alta probabilidade	Alta probabilidade
Altíssima probabilidade	Probabilidade altíssima

Regras de validação

Regra	Descrição
government_document_available	Verifica se o documento está disponível na base do governo.
government_document_approved	Verifica a autenticidade do documento com a base do governo.
revisão_manual_do_liveness	Esta regra envia a selfie para verificação manual anti-spoofing.
is_biometrics_approved	Verifica se a similaridade da selfie encontrada na base está abaixo do limiar de confiança configurado no template de perfil.