Endpoints de validação
Consulte os endpoints técnicos de comparação facial e validação cadastral.
Tipos de validação
Comparação facial
Compare duas imagens faciais e receba similaridade, confiança e compatibilidade.
Validação cadastral
Compare dados informados com dados cadastrais disponíveis e receba score, divergências e ação recomendada.
Como funciona
Cada validação recebe dados de entrada, executa as regras do serviço correspondente e retorna um resultado estruturado.1
Envie os dados de entrada
Informe imagens, documentos e dados cadastrais conforme o tipo de validação.
2
A API executa a validação
A Lazy Data normaliza os dados, consulta referências disponíveis e aplica as regras do serviço.
3
Receba o resultado estruturado
A resposta retorna score, status, similaridade, divergências ou decisão recomendada, conforme a validação.
4
Aplique sua política interna
Use o retorno para aprovar, reprovar, revisar manualmente ou solicitar novos dados.
Retorno padrão
As respostas seguem o padrão da API:result contém o objeto específico da validação executada.
Comparação facial
A comparação facial recebe duas imagens e calcula se elas provavelmente representam a mesma pessoa. Campos principais do resultado:Comparação facial
Entenda uso, requisitos de imagem, threshold e interpretação do resultado.
Validação cadastral
A validação cadastral compara dados enviados com dados disponíveis na base e retorna uma decisão estruturada. Campos principais do resultado:Validação cadastral
Entenda score, divergências, ações recomendadas e modelos PF/PJ.
Cobrança
A cobrança ocorre quando a validação é concluída com sucesso pelo serviço, independentemente do resultado indicar aprovação, reprovação ou necessidade de revisão. Em chamadas de teste, não há débito de saldo.O resultado da validação não deve ser interpretado isoladamente como decisão final. A aprovação, reprovação ou revisão depende da política de risco da sua operação.
Chamada de teste
As validações podem ser executadas em ambiente de teste para validar integração sem consumir saldo. Envie o header:Ambiente de teste
Veja como habilitar chamadas de teste usando o header correto.
Respostas e erros
Quando uma validação não puder ser executada, a API retorna umcode e uma message explicando o motivo.
Exemplo:
- payload inválido;
- documento inválido;
- imagem inválida;
- face não detectada;
- validação indisponível para a conta;
- saldo ou limite insuficiente;
- falha temporária de provedor.
Códigos de erro de validações
Veja os códigos retornados pelas validações e seus significados.
Boas práticas
- Use sandbox para validar payloads antes de chamadas reais.
- Não armazene imagens, documentos ou retornos sensíveis em logs públicos.
- Trate falhas de payload separadamente de falhas temporárias de provedor.
- Combine validação cadastral e comparação facial quando o fluxo exigir maior rigor.
- Encaminhe resultados inconclusivos para revisão manual quando houver impacto sensível.
- Registre apenas os campos necessários para auditoria e suporte.
Próximos passos
Comparação facial
Veja como comparar duas imagens faciais.
Validação cadastral
Veja como validar dados cadastrais de pessoas e empresas.
API de comparação facial
Consulte parâmetros e respostas do endpoint.
API de validação cadastral
Consulte parâmetros e respostas do endpoint.