O endpoint /api/SimilarityArgentina permite comparar os dados informados de uma pessoa física com registros da base, retornando métricas de similaridade (distance) e descrições sobre o nível de correspondência entre as informações.
Similarity - Argentina
Consulta responsável por comparar a integridade dos dados da Pessoa Física inseridos com os dados da base.
Casos de Uso
- Onboarding de clientes internacionais
- Prevenção de roubo de identidade
- Validação de dados cadastrais de pessoas físicas
- Apoio a processos de KYC (Know Your Customer)
- Análise de consistência de dados informados.
Aplicações
- Onboarding de Clientes e Fornecedores
- Prevenção de Roubo de Identidade
Benefícios
- Verificação de integridade de dados em base internacional
- Redução de fraudes cadastrais
- Comparação inteligente com métricas de similaridade
- Suporte a validação automatizada de identidade
- Integração simples com fluxos de cadastro.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/SimilarityArgentinaEndpoint
GET https://apiv3.directd.com.br/api/SimilarityArgentina?DNI={0}&Name={1}&Surname={2}&DOB={3}&Address={4}&City={5}&State={6}&PostCode={7}&Phone={8}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Similarity - Argentina.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Address: Informa o endereço do indivíduo
- City: Cidade do registro em questão
- Descrição dos Cinco Primeiros Dígitos: Descrição do registro para os cinco primeiro dígitos informados.
- Description: Descrição do registro
- Distance: Informa, com valores, a distância entre o termo perquisado e o comparado
- Distância dos Cinco Primeiros Dígitos: Informa, com valores, a distância entre o termo perquisado e o comparado.
- DNI: Informa a documento nacional de Identidad (DNI).
- DOB: Data de nascimento do indivíduo
- Name: Nome do indivíduo/registro
- Phone: Telefones vinculados ao indivíduo
- PostCode: Número CEP/código postal do endereço
- State: Nome do estado
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
DNI | string | Sim | |
NAME | string | Sim | |
SURNAME | string | Sim | |
DOB | string | Sim | |
ADDRESS | string | Não | |
CITY | string | Não | |
STATE | string | Não | |
POSTCODE | string | Não | |
PHONE | string | Não | O parâmetro PHONE pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"dni": {
"dni": "string",
"description": "string",
"distance": 0
},
"name": {
"name": "string",
"description": "string",
"distance": 0
},
"dob": {
"dob": "string",
"description": "string",
"distance": 0
},
"address": {
"address": "string",
"description": "string",
"distance": 0
},
"city": {
"city": "string",
"description": "string",
"distance": 0
},
"state": {
"state": "string",
"description": "string",
"distance": 0
},
"postCode": {
"postCode": "string",
"description": "string",
"distance": 0,
"descriptionOnFirstFiveDigits": "string",
"distanceOnFirstFiveDigits": 0
},
"phone": [
{
"phone": "string",
"description": "string",
"distance": 0
}
]
}
}Erros Comuns
| Código | Descrição |
|---|---|
400 | Requisição Inválida: a requisição está incorreta ou os parâmetros são inválidos. |
401 | Não Autenticado: o usuário não forneceu as credenciais corretas para acessar o recurso. |
403 | Não Autorizado: o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
404 | Não Encontrado: o servidor não encontrou uma representação atual do recurso solicitado. |
408 | Tempo Esgotado: o servidor não conseguiu retornar a requisição no prazo estabelecido. |
500 | Falha ao Realizar Consulta: o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
503 | Consulta em Manutenção: a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |
Notas Importantes
- Informe apenas um único documento por requisição
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228