> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lazydata.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Visão geral
> Entenda como funcionam as validações da Lazy Data.
As **validações** permitem confirmar informações enviadas pelo usuário ou pela sua aplicação usando regras objetivas de análise.
A Lazy Data oferece validações para apoiar fluxos de cadastro, onboarding, análise de risco, revisão manual e prevenção de inconsistências.
Consulte os endpoints técnicos de comparação facial e validação cadastral.
## Tipos de validação
Compare duas imagens faciais e receba similaridade, confiança e compatibilidade.
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.
Informe imagens, documentos e dados cadastrais conforme o tipo de validação.
A Lazy Data normaliza os dados, consulta referências disponíveis e aplica as regras do serviço.
A resposta retorna score, status, similaridade, divergências ou decisão recomendada, conforme a validação.
Use o retorno para aprovar, reprovar, revisar manualmente ou solicitar novos dados.
## Retorno padrão
As respostas seguem o padrão da API:
```json theme={null}
{
"code": 200,
"message": "Validação concluída com sucesso.",
"result": {}
}
```
O campo `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:
| Campo | Descrição |
| ------------ | ------------------------------------------------------ |
| `matched` | Indica se a similaridade atingiu o limite configurado. |
| `similarity` | Percentual de similaridade entre as faces comparadas. |
| `confidence` | Confiança da detecção facial usada na comparação. |
| `threshold` | Limite mínimo aplicado na decisão. |
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:
| Campo | Descrição |
| -------------------- | ---------------------------------------------------------------------- |
| `status` | Resultado consolidado, como `approved`, `manual_review` ou `rejected`. |
| `score` | Pontuação final de compatibilidade. |
| `recommended_action` | Ação sugerida para o fluxo do cliente. |
| `field_results` | Resultado individual por campo comparado. |
| `critical_errors` | Divergências críticas encontradas na validação. |
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:
```http theme={null}
x-ambient: sandbox
```
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 um `code` e uma `message` explicando o motivo.
Exemplo:
```json theme={null}
{
"code": 43001,
"message": "Validação não encontrada.",
"result": null
}
```
Erros comuns podem ocorrer por:
* 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.
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
Veja como comparar duas imagens faciais.
Veja como validar dados cadastrais de pessoas e empresas.
Consulte parâmetros e respostas do endpoint.
Consulte parâmetros e respostas do endpoint.