TrustyData Docs
Site Tarifs Contact

Premier appel

De la création du compte au premier appel réussi, en 5 minutes. Aucun outil particulier — un terminal et curl suffisent.

1. Récupérer une clé d'API

Créez un compte sur trustydata.fr/inscription-beta. Une fois validé, vous accédez à votre espace client. Le plan Discovery (gratuit, 5 000 requêtes/mois) est attribué automatiquement.

Dans Espace client → Clés d'API, créez une clé et copiez-la immédiatement — elle ne sera plus jamais affichée en clair.

Une clé = un client

Une clé d'API identifie un seul client. Ne la partagez pas entre projets, ne l'embarquez pas dans une page web ou un binaire distribué. Pour les besoins multi-tenants (agences), un mode dédié existe — voir Authentification.

2. Premier appel — autocomplétion d'adresse

Toutes les requêtes prennent la même base URL et le même header d'authentification :

cURL

curl -H "Authorization: Bearer VOTRE_CLE_API" \
  "https://api.trustydata.app/services/v1/address/autocomplete?q=215+chemin+acacias+sainte-euphemie"

Python (requests)

import requests

response = requests.get(
    "https://api.trustydata.app/services/v1/address/autocomplete",
    params={"q": "215 chemin acacias sainte-euphemie"},
    headers={"Authorization": "Bearer VOTRE_CLE_API"},
)
response.raise_for_status()
data = response.json()
print(data["suggestions"][0]["adresse"])

Node.js (fetch)

const url = new URL("https://api.trustydata.app/services/v1/address/autocomplete");
url.searchParams.set("q", "215 chemin acacias sainte-euphemie");

const response = await fetch(url, {
  headers: { Authorization: "Bearer VOTRE_CLE_API" },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data.suggestions[0].adresse);

3. Lire la réponse

Toutes les réponses suivent une structure stable : status, message, et le contenu utile (suggestions, matches, results selon l'endpoint). 

{
  "status": "OK",
  "message": "",
  "suggestions": [
    {
      "score": 0.99,
      "adresse": "215 Chemin des Acacias, 01600 Sainte-Euphémie",
      "id": "8dce49b2-8e26-4e72-a81d-ff1c1f0072f6",
      "id_ban": "01353_0100_00215",
      "numero": "215",
      "nom_voie": "Chemin des Acacias",
      "code_postal": "01600",
      "nom_commune": "Sainte-Euphémie",
      "code_insee": "01353"
    }
  ]
}

Le champ score (0 à 1) indique la pertinence du rapprochement par rapport à la requête. Un score ≥ 0,9 est un match fiable ; entre 0,6 et 0,9 c'est un candidat à vérifier ; en dessous, mieux vaut affiner la requête.

Réponse enrichie par plan

En plan Discovery, la réponse contient les champs base BAN (numéro, voie, code postal, commune, code INSEE, identifiant BAN). Les plans supérieurs ajoutent progressivement la position (Starter), le géocodage IRIS (Growth), et la grille statistique INSEE Filosofi (Business). Voir Plans & quotas.

4. Vérifier une adresse

L'autocomplétion est faite pour un usage interactif (champ de saisie). Pour vérifier une adresse déjà saisie (depuis un formulaire, un CRM, un fichier import), utilisez plutôt POST /address/verify qui retourne un verdict explicite (doublon_certain / doublon_probable). 

curl -X POST \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d '{"q":"32 bis rue de Labbeville 95690 Nesles la Vallée","max_results":5}' \
  "https://api.trustydata.app/services/v1/address/verify"

Une adresse par requête

L'API traite une adresse par appel. Pour des volumes (qualification de fichier, dédoublonnage batch), intégrez-la dans un script ou un pipeline ETL côté client — pas de mode bulk.

Prochains pas