Saltar para o conteúdo principal
POST
Identifica pessoas (nomes, datas de nascimento, moradas, telefones, e-mails, números de identificação nacionais) e uma pontuação de correspondência de nomes a partir de um e-mail e/ou número de telefone, através de uma rede global de informação de risco. É cobrado por pedido. A Didit disponibiliza este serviço através de POST /v3/database-validation/ para que possa comparar os dados enviados com a rede de identidade ligada e receber resultados de correspondência normalizados. Trata-se de uma rede de enriquecimento de terceiros, e não de um registo governamental oficial e fidedigno: não apresente os seus resultados como verificação de fonte primária.

Cobertura

  • Cobertura: 50+ mercados
  • País: Global
  • ID do serviço: glb_identity_enrichment
  • Domínio de dados: Identidade
  • Categoria: IdentityEnrichment

Entradas

  • Entradas obrigatórias: —
  • Entradas opcionais: email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Consentimento: Obrigatório
  • Disponibilidade no fluxo: Apenas API autónoma
  • Cobertura: 50+ mercados
  • Preço: $0.20 por consulta bem-sucedida
Este serviço não é disponibilizado como passo de Validação de base de dados dentro de um fluxo. Essa restrição limita onde a verificação é executada, e não o que pode enviar: chame-o na API autónoma, onde fornece os dados diretamente.

Parâmetros do corpo

string
padrão:"GLB"
obrigatório
Código de país ISO 3166-1 alfa-3 deste serviço de base de dados.Exemplo: GLB
string
padrão:"glb_identity_enrichment"
obrigatório
Array que contém o ID deste serviço. Fixar o serviço mantém o pedido limitado a esta base de dados específica.Exemplo: glb_identity_enrichment
Consentimento explícito do utilizador final para este serviço.Exemplo: true
string
padrão:"john.doe@example.com"
Endereço de e-mail.Exemplo: john.doe@example.com
string
padrão:"+15550101000"
Número de telefone em formato internacional.Exemplo: +15550101000
string
padrão:"John"
Nome próprio a validar.Exemplo: John
string
padrão:"Doe"
Apelido a validar.Exemplo: Doe
string
Nome legal completo a validar.Exemplo: John Doe
string
padrão:"US"
País de residência opcional, em código ISO 3166-1 alfa-2. Usado apenas para focar a pesquisa de identidade.Exemplo: US
string
padrão:"user-1234"
A sua referência estável do utilizador para esta pessoa, como o seu ID de utilizador interno. A Didit usa-a para associar as verificações autónomas ao mesmo utilizador final e reduzir o ruído na deteção de duplicados.Exemplo: user-1234

Regras de entrada e notas de validação

  • Indique pelo menos um de email ou phone: são as chaves de pesquisa. Um pedido sem nenhum dos dois não pode executar uma pesquisa de enriquecimento e é rejeitado antes da consulta à fonte (não é cobrado).
  • Adicione um nome sempre que o tiver: a fonte pontua a pesquisa em função dele. Envie first_name e last_name, que são os campos que o mapa validation da resposta compara. Um pedido que envie apenas full_name continua a ser pontuado pela fonte, mas é devolvido com um validation vazio e um match_type de nível superior nulo.
  • country_of_residence é um código ISO 3166-1 alfa-2 usado para focar a pesquisa.
  • Cada pesquisa concluída é cobrada, incluindo a que não identifica nenhuma pessoa (persons_found: 0). Apenas um pedido rejeitado antes da pesquisa, sem email nem phone, é gratuito.

How to call it

Dados devolvidos

Os campos exatos apresentados em source_data dependem do que o registo devolve. O exemplo gerado para glb_identity_enrichment documenta atualmente esta estrutura normalizada:
  • first_name
  • last_name
  • persons_found

Preços e SLAs

As consultas de Global - Identity Enrichment só são faturadas quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $0.20 USD.
  • Faturação: por consulta bem-sucedida. Não lhe é cobrado quando o registo está inacessível, quando faltam campos obrigatórios ou quando o pedido é rejeitado antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte a jusante varia consoante o país e o conjunto de dados.

Continuar a ler

Última modificação em 7 de novembro de 2026