Passer au contenu principal
POST
Identifie des personnes (noms, date de naissance, adresses, numéros de téléphone, e-mails, identifiants nationaux) ainsi qu’un score de correspondance des noms à partir d’une adresse e-mail et/ou d’un numéro de téléphone, via un réseau mondial d’analyse des risques. Facturé à chaque requête. Didit expose ce service via POST /v3/database-validation/ afin de vérifier les données soumises par rapport au réseau d’identité connecté et de recevoir des résultats de correspondance normalisés. Il s’agit d’un réseau d’enrichissement tiers, et non d’un registre gouvernemental faisant autorité : ne présentez pas ses résultats comme une vérification auprès d’une source primaire.

Couverture

  • Couverture : 50+ marchés
  • Pays : Monde
  • Identifiant du service : glb_identity_enrichment
  • Domaine de données : Identité
  • Catégorie : IdentityEnrichment

Entrées

  • Entrées obligatoires : —
  • Entrées facultatives : email, phone, first_name, last_name, full_name, country_of_residence, vendor_data
  • Consentement : Obligatoire
  • Disponibilité dans un workflow : API autonome uniquement
  • Couverture : 50+ marchés
  • Prix : $0.20 par requête réussie
Ce service n’est pas proposé comme étape de Validation en base de données dans un workflow. Cette restriction porte sur l’endroit où la vérification s’exécute, et non sur ce que vous pouvez lui envoyer : appelez-le sur l’API autonome, où vous fournissez directement les entrées.

Paramètres du corps de requête

string
défaut:"GLB"
requis
Code pays ISO 3166-1 alpha-3 pour ce service de base de données.Exemple : GLB
string
défaut:"glb_identity_enrichment"
requis
Tableau contenant l’identifiant de ce service. Fixer le service limite la requête à cette base de données précise.Exemple : glb_identity_enrichment
Consentement explicite de l’utilisateur final pour ce service.Exemple : true
string
défaut:"john.doe@example.com"
Adresse e-mail.Exemple : john.doe@example.com
string
défaut:"+15550101000"
Numéro de téléphone au format international.Exemple : +15550101000
string
défaut:"John"
Prénom à valider.Exemple : John
string
défaut:"Doe"
Nom de famille à valider.Exemple : Doe
string
Nom légal complet à valider.Exemple : John Doe
string
défaut:"US"
Code pays ISO 3166-1 alpha-2 du pays de résidence, facultatif. Utilisé uniquement pour cibler la recherche d’identité.Exemple : US
string
défaut:"user-1234"
Votre référence stable pour cette personne, par exemple votre identifiant interne d’utilisateur. Didit s’en sert pour relier les vérifications autonomes au même utilisateur final et réduire le bruit des détections de doublons.Exemple : user-1234

Règles de saisie et notes de validation

  • Fournissez au moins l’un des champs email ou phone : ce sont les clés de recherche. Une requête sans l’un ni l’autre ne peut pas effectuer de recherche d’enrichissement et est rejetée avant la recherche dans la source (non facturée).
  • Ajoutez un nom dès que vous en disposez : la source attribue un score à la recherche en fonction de ce nom. Envoyez first_name et last_name, car ce sont les champs que compare la carte validation de la réponse. Une requête qui n’envoie que full_name est tout de même notée par la source, mais renvoie une validation vide et un match_type de premier niveau à null.
  • country_of_residence est un code ISO 3166-1 alpha-2 utilisé pour cibler la recherche.
  • Chaque recherche terminée est facturée, y compris celle qui ne permet d’identifier aucune personne (persons_found: 0). Seule une requête rejetée avant la recherche, c’est-à-dire sans email ni phone, est gratuite.

Comment l’appeler

Données renvoyées

Les champs exacts exposés dans source_data dépendent de ce que renvoie le registre. L’exemple généré pour glb_identity_enrichment documente actuellement cette structure normalisée :
  • first_name
  • last_name
  • persons_found

Tarifs et SLA

Les requêtes Global - Identity Enrichment ne sont facturées que lorsque Didit reçoit un résultat concluant de la source de validation.
  • Prix par appel : $0.20 USD.
  • Facturation : par requête réussie. Vous n’êtes pas facturé lorsque le registre est injoignable, lorsque des champs obligatoires manquent, ou lorsque la requête est rejetée avant d’atteindre la source.
  • Latence : p95 typique < 2 s.
  • Disponibilité : 99.9% par trimestre côté Didit ; la disponibilité des sources en aval varie selon le pays et le jeu de données.

Pour aller plus loin

Dernière modification le 7 novembre 2026