Biometria facial

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

Seção: dadosOficiais

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	Number	Percentual de similaridade da foto do documento com a base oficial
probabilidade	String	Probabilidade de autenticidade da foto do documento com a base oficial

Exemplo

{
  "dadosOficiais": {
    "código": "01",
    "confiança": 0.9600528478622437,
    "probabilidade": "Altíssima probabilidade"
  }
}

Valores possíveis

código

Código	Descrição
01	Sucesso (comparação realizada). confiança, statusDeConfiança e probabilidade são retornados apenas quando código é 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 não encontrada")
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 é 01.

Valor (resposta da API)	Descrição
Probabilidade baixíssima	Probabilidade muito baixa
Probabilidade baixa	Probabilidade baixa
Probabilidade média	Probabilidade média
Probabilidade alta	Probabilidade alta
Probabilidade altíssima	Probabilidade muito alta

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.
liveness_manual_revision	Esta regra envia a selfie para verificação manual anti-spoofing.