Passer au contenu principal
POST
Vérifie les données par rapport aux données de recensement issues d’agences gouvernementales. Didit expose ce service via POST /v3/database-validation/ afin que vous puissiez vérifier les données soumises auprès de la source faisant autorité et recevoir des résultats de correspondance normalisés.

Couverture

  • Couverture : ~ 85%
  • Pays : France
  • ID du service : fra_residential
  • Domaine de données : Adresse
  • Catégorie : Résidentielle

Entrées

  • Entrées obligatoires : first_name, last_name, date_of_birth, address.street_1, address.postal_code
  • Entrées facultatives : address.street_2, address.city, address.region, vendor_data
  • Consentement : Non requis
  • Disponibilité dans le workflow : Disponible dans le workflow
  • Couverture : ~ 85%
  • Prix : $1.49 par requête réussie

Paramètres du corps de la requête

string
défaut:"FRA"
requis
Code pays ISO 3166-1 alpha-3 pour ce service de base de données.Exemple : FRA
string
défaut:"fra_residential"
requis
Tableau contenant l’ID de ce service. Le fait de spécifier le service limite la requête à cette base de données précise.Exemple : fra_residential
string
défaut:"John"
requis
Prénom à valider.Exemple : John
string
défaut:"Doe"
requis
Nom de famille à valider.Exemple : Doe
string
défaut:"1990-01-01"
requis
Date de naissance au format YYYY-MM-DD.Exemple : 1990-01-01
object
requis
Objet d’adresse résidentielle structuré. Utilisez street_1, street_2, city, region, postal_code et country. Une chaîne d’adresse complète au format ancien reste acceptée, mais non recommandée.Exemple : {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
défaut:"user-1234"
Votre référence utilisateur 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 lié à la détection des doublons.Exemple : user-1234

Règles de saisie et notes de validation

  • Pour les services d’adresse, envoyez les champs d’adresse structurés plutôt qu’une seule chaîne address lorsque c’est possible.
  • address.street_1 correspond à l’adresse de la voie, numéro et type de voie compris.
  • address.street_2 correspond à l’appartement, à l’unité, au bâtiment, à l’étage ou à toute ligne d’adresse supplémentaire. Ne l’envoyez que si vous l’avez.
  • address.city correspond à la ville, à la banlieue, au district, à la localité ou au quartier.
  • address.region correspond à l’État, à la province, à la région ou à la ville.
  • address.postal_code correspond au code postal.
  • Les services de base de données fondés sur l’adresse exigent au minimum l’adresse de la voie et le code postal ; les requêtes rejetées avant la recherche dans la source ne sont pas facturées.

Comment l’appeler

Données renvoyées

Les champs exacts présents dans source_data dépendent de ce que renvoie le registre. L’exemple généré pour fra_residential documente actuellement cette structure normalisée :
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • street

Tarifs et SLA

Les requêtes France Residential ne sont facturées que lorsque Didit reçoit un résultat concluant de la source de validation.
  • Prix par appel : $1.49 USD.
  • Facturation : par requête réussie. Vous n’êtes pas facturé lorsque le registre est injoignable, lorsque des champs obligatoires sont manquants 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é de la source en aval varie selon le pays et le jeu de données.

Pour aller plus loin

Dernière modification le 7 novembre 2026