Saltar al contingut principal
POST
Resol persones (noms, data de naixement, adreces, telèfons, correus electrònics i documents d’identitat nacionals) i una puntuació de coincidència de nom a partir d’un correu electrònic i/o un número de telèfon, mitjançant una xarxa mundial d’informació de risc. Es cobra per sol·licitud. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis contrastar les dades enviades amb la xarxa d’identitat connectada i rebre resultats de coincidència normalitzats. Es tracta d’una xarxa d’enriquiment de tercers, no d’un registre oficial governamental; no presentis els seus resultats com a verificació de fonts primàries.

Cobertura

  • Cobertura: 50+ mercats
  • País: Global
  • ID del servei: glb_identity_enrichment
  • Domini de dades: Identitat
  • Categoria: IdentityEnrichment

Entrades

  • Entrades obligatòries: -
  • Entrades opcionals: email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Només API autònoma
  • Cobertura: 50+ mercats
  • Preu: $0.20 per consulta satisfactòria
Aquest servei no s’ofereix com a pas de Validació en bases de dades dins d’un flux de treball. Això restringeix on s’executa la comprovació, però no què pots enviar-hi: crida’l a l’API autònoma, on proporcionis les dades directament.

Paràmetres del cos

string
predeterminat:"GLB"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de bases de dades.Exemple: GLB
string
predeterminat:"glb_identity_enrichment"
requerit
Matriu que conté aquest ID de servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple: glb_identity_enrichment
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
string
predeterminat:"john.doe@example.com"
Adreça de correu electrònic.Exemple: john.doe@example.com
string
predeterminat:"+15550101000"
Número de telèfon en format internacional.Exemple: +15550101000
string
predeterminat:"John"
Nom de pila a validar.Exemple: John
string
predeterminat:"Doe"
Cognom a validar.Exemple: Doe
string
Nom legal complet a validar.Exemple: John Doe
string
predeterminat:"US"
Codi de país ISO 3166-1 alpha-2 de residència, opcional. Només s’utilitza per centrar la cerca d’identitat.Exemple: US
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les comprovacions autònomes al mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • Proporciona almenys un dels camps email o phone: són les claus de consulta. Una sol·licitud sense cap dels dos no pot fer una consulta d’enriquiment i es rebutja abans de la consulta a la font (no es cobra).
  • Afegeix un nom sempre que en tinguis: la font puntua la consulta segons aquest nom. Envia first_name + last_name: són els camps que compara el mapa validation de la resposta. Una sol·licitud que només envia full_name és igualment puntuada per la font, però torna amb un validation buit i un match_type de nivell superior nul.
  • country_of_residence és un codi ISO 3166-1 alpha-2 que s’utilitza per centrar la consulta.
  • Cada consulta completada es cobra, inclosa una que no resol cap persona (persons_found: 0). Només és gratuïta una sol·licitud rebutjada abans de la consulta, és a dir, quan no s’ha enviat ni email ni phone.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a glb_identity_enrichment documenta actualment aquesta forma normalitzada:
  • first_name
  • last_name
  • persons_found

Preus i SLA

Les consultes de Global - Identity Enrichment només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.20 USD.
  • Facturació: per consulta satisfactòria. No se’t factura quan el registre és inaccessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
  • Latència: p95 típica < 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font externa varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026