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, 20 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. Aller plus loin avec les adresses

L'autocomplétion n'est qu'un des quatre endpoints adresse. Pour vérifier une adresse déjà saisie (verdict match_exact / match_probable), consulter une fiche ou chercher autour d'un point : voir le guide Adresses.

Prochains pas