Documentation TrustyData API

L'API TrustyData expose des services de qualité de données pour les adresses françaises : autocomplétion, vérification géographique (BAN), géocodage enrichi (IRIS, Filosofi), calcul d'itinéraire et matrices distance/durée.

Bêta publique

L'API est en bêta. Les contrats publics sont stables — aucune rupture rétro-incompatible n'est prévue. Les évolutions ajoutent des champs, jamais en retirent.

Premier appel en 30 secondes

Toute requête s'authentifie avec une clé Bearer. Voici un exemple d'autocomplétion d'adresse :

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

Réponse abrégée :

{
  "status": "OK",
  "suggestions": [
    {
      "score": 0.99,
      "adresse": "215 Chemin des Acacias, 01600 Sainte-Euphémie",
      "id_ban": "01353_0100_00215",
      ...
    }
  ]
}

Pas encore de clé ? Créez un compte bêta — le plan Discovery est gratuit à vie, 5 000 requêtes par mois.

Que documente ce site ?

Section	Pour quoi
Premier appel	Obtenir une clé, faire le premier appel, comprendre la réponse
Authentification	Bearer token, rotation, sécurité côté serveur
Plans & quotas	Ce que chaque plan ouvre, quotas mensuels, dépassement
Codes d'erreur	Mapping HTTP → cause → action
Attribution OSM	Mention ODbL obligatoire pour `/route/*`
Référence complète	Tous les endpoints, payloads, codes de réponse — interactif

Plans disponibles

Discovery — gratuit à vie, 5 000 requêtes/mois, réponses minimales
Starter — ajoute la position WGS84 et Lambert 93
Growth — ajoute le géocodage IRIS et l'accès aux matrices distance/durée
Business — ajoute la grille statistique INSEE Filosofi et le calcul d'itinéraire complet

Support

Une question, un retour, un bug ? Contactez-nous.