Intégration des API open data françaises
L'API gouv dans le produit, jamais en dur dans le front
Nous exploitons Adresse, Géo, API Particulier, cadastre ou météo dans vos parcours. Aucune garantie de disponibilité : cache, solution de repli et habilitation Datapass se décident avant l'écran.
- Clients d'API gouv en production
- cache et repli
- Datapass cadré
Qu'est-ce qu'une API open data française et quand la faire intégrer ?
Les API open data françaises exposent des référentiels publics : adresses, communes, météo, transport, cadastre, textes, parfois le statut d'un usager. Elles vivent sur api.gouv.fr et data.gouv.fr, avec des accès ouverts ou un Datapass selon le service. On fait développer l'intégration quand la donnée doit entrer dans un parcours (autocomplétion, éligibilité, tarification) plutôt que dans un export. Le travail consiste à isoler le fournisseur, tenir sous le débit, et dégrader le produit quand la source publique est sourde, parce qu'il n'y a souvent pas de contrat opposable.
Les API open data que nous intégrons
API Adresse
Géocodage BAN : autocomplétion, inverse, traitement par lot, code INSEE.
Météo France
Prévisions et observations, quand la météo entre dans vos règles métier.
URSSAF
Données et contrôles sociaux, pour vos parcours employeur et paie.
SNCF & transport
Horaires, perturbations et données de transport dans vos parcours.
API Particulier
Le statut d'un usager, pour préremplir ou contrôler un droit, via Datapass.
France Travail
Offres et données emploi, à brancher sur un parcours métier, pas un copier-coller.
DVF & cadastre
Valeurs foncières et parcelles, pour l'éligibilité et l'estimation métier.
Legifrance
Textes officiels, quand votre produit doit citer ou suivre le droit positif.
API Géo
Communes, EPCI, départements, régions : le découpage administratif.
Ce qui casse quand l'API gouv bouge
Les données publiques existent. Tant que l'URL est collée dans le front, l'éligibilité se décide trop tard et une panne gouv emporte le produit.
L'adresse se tape encore en quatre champs
L'autocomplétion BAN remplit le formulaire. Moins de colis perdus, moins de codes postaux inventés.
L'éligibilité se décide après la demande
Le territoire, le statut ou la donnée métier tombe pendant la saisie. L'utilisateur n'envoie plus un dossier hors périmètre.
On a collé l'URL gouv en dur dans le front
Une couche d'abstraction, une URL en configuration, un cache. Quand le domaine change, on change une variable, pas vingt écrans.
L'API publique tombe, et le produit avec
Dégradation prévue : saisie manuelle, dernière valeur connue, message clair. Un incident gouv n'est plus une panne totale.
Ce que chaque API gouv implique concrètement
API Adresse
GéocodageLe meilleur cluster de la catégorie : autocomplétion, géocodage inverse, lots. Opérée par l'IGN sur la Géoplateforme. L'ancienne URL data.gouv est un piège. Le score ne se lit pas comme une probabilité ; l'acceptation se décide sur le niveau de correspondance. C'est la page la plus actionnable du bloc.
- Autocomplétion dans le tunnel
- Code INSEE et identifiant stables
- Lots avec file, pas en parallèle naïf
API Géo
TerritoiresLe découpage administratif : communes, EPCI, départements, régions. Sert à dériver le territoire d'un dossier depuis un code commune, souvent à côté de l'API Adresse. Simple en apparence, indispensable pour ne pas coder Paris comme une seule commune.
- Territoire dérivé du code commune
- EPCI et départements
- Complément naturel d'Adresse
API Particulier
Statut usagerLe statut d'un usager (quotient, emploi, famille selon les API habilitées) pour préremplir ou contrôler un droit. Datapass, FranceConnect selon les cas : ce n'est pas une API ouverte. Le cadrage commence par l'habilitation, pas par le formulaire.
- Droit contrôlé pendant la saisie
- Datapass avant le code
- Minimisation des données
DVF & cadastre
FoncierDemandes de valeurs foncières et parcelles, pour l'éligibilité, l'estimation ou le ciblage territorial. Se combine souvent avec l'API Adresse et l'API Géo. On stocke ce qui sert au dossier, pas le cadastre entier.
- Foncier dans la règle métier
- Parcelle rattachée au dossier
- Combinable avec Adresse et Géo
France Travail
EmploiOffres et données emploi à faire vivre dans un outil métier (matching, suivi, publication). Sans fiche détaillée ici : l'accès et le périmètre se confirment au cadrage. Une page emploi qui copie un portail n'est pas une intégration.
- Offres dans le métier
- Accès confirmé au cadrage
- Pas un miroir de portail
Legifrance
TextesTextes officiels à citer ou à suivre dans un produit (conformité, aide à la décision). Sans routes inventées : le cadrage fixe le corpus, la fraîcheur et l'affichage de la source. Une copie hors licence n'est pas une intégration.
- Texte à jour dans le produit
- Source affichée
- Corpus cadré
Météo France
PrévisionsPrévisions et observations pour un produit où la météo est une règle (intervention, logistique, agriculture, énergie). Sans quotas inventés ici : le cadrage fixe le pas de temps, la zone, et ce que vous stockez versus ce que vous interrogez à la volée.
- Météo dans la règle métier
- Zone et pas de temps cadrés
- Cache plutôt que l'appel à chaque vue
SNCF & transport
TransportHoraires, perturbations, parfois d'autres opérateurs de transport. Utile dans un parcours de déplacement ou de logistique. Le cadrage fixe le réseau concerné et le niveau de fraîcheur exigé, sans coller une URL transport en dur dans le front.
- Horaires dans le parcours
- Perturbations visibles
- Fournisseur isolé
URSSAF
SocialDonnées et contrôles utiles aux parcours employeur, déclaration ou éligibilité sociale. L'accès n'est pas toujours ouvert : Datapass et habilitation se confirment au cadrage. Nous ne promettons pas une route tant que votre droit d'accès n'est pas réel.
- Parcours employeur ou paie
- Habilitation confirmée
- Pas de route inventée
Quatre règles métier nées d'une source officielle
Autocomplétion d'adresse dans le tunnel
API Adresse, côté serveur, avec cache. Quatre champs libres sortent du formulaire.
Éligibilité territoriale
API Géo, communes, zonages. La règle se calcule avant la demande, pas après un rejet.
Règle météo ou transport
Un seuil officiel déclenche un comportement métier. La source est citée, versionnée.
Contrôle d'un droit usager
API Particulier quand Datapass l'autorise. Ce n'est pas un header à ajouter, c'est un agrément.
Produit, métier, engineering : un client, pas vingt écrans
Nous ne « collons pas data.gouv ». Nous posons un contrat de source : cache, repli, Datapass, réutilisation.
Le produit raccourcit le formulaire
Moins de champs, moins d'erreurs d'adresse. Le tunnel s'appuie sur une source officielle.
Le métier cite la règle
Éligibilité, zonage, météo : la décision a une provenance. Ce n'est plus un tableur interne.
L'engineering a un seul client HTTP
Les URLs bougent. Vingt écrans qui appellent gouv, c'est vingt incidents. Nous centralisons.
Le juridique cadre la réutilisation
Licence, conservation, interdiction de tout stocker (cadastre). Cela se tranche, ce n'est pas un détail.
Ce que nous avons livré, et qui s'applique ici
Ce qu'une API open data force comme méthode
Contrat de source
API, version, champs, fréquence, propriétaire interne.
Livrable : fiche de sourceCache et repli
TTL de cache, timeout, message de repli, file.
Livrable : stratégie de repliDatapass
Périmètre Datapass, pièces, environnement d'homologation.
Livrable : dossier Datapass ou N/ARéutilisation légale
Licence, durée de cache, ce que l'on n'a pas le droit de stocker.
Livrable : note de réutilisationCe que personne ne vous dit avant de signer
Pas de contrat, pas de SLA
Beaucoup d'API gouv sont ouvertes sans engagement opposable. Le produit doit dégrader. Compter sur une disponibilité « comme un SaaS payant » est une erreur de cadrage.
Datapass n'est pas un header à ajouter
API Particulier, certaines API sociales : l'habilitation précède le code. Commencer le formulaire avant l'accès fait perdre des semaines.
Les URL bougent
L'API Adresse a changé d'opérateur et de domaine. Une URL collée en dur dans le front est une dette. La base vit en configuration.
On ne stocke pas le cadastre entier
La donnée utile au dossier se conserve, le reste se re-interroge. Copier un référentiel public « au cas où » pose des questions de licence, de fraîcheur et de coût.
Ce que nous mesurons sur un projet open data
Intégration des API open data françaises : vos questions
Trois étapes. D'abord identifier le service et le mode d'accès : ouvert, ou Datapass. Ensuite construire une couche d'abstraction, avec cache, file sous le débit, URL en configuration, et une dégradation si la source est sourde. Enfin recetter sur vos données réelles. La difficulté n'est pas de trouver l'endpoint sur api.gouv.fr, c'est de faire tenir la donnée dans un parcours produit sans coller le fournisseur au front.
Beaucoup sont ouvertes, sans clé, sous licence ouverte. D'autres exigent un compte, un token ou un Datapass. Gratuit ne veut pas dire sans contrainte : débit, fraîcheur, absence de SLA. Nous revérifions le mode d'accès au cadrage de chaque API, plutôt que de généraliser à tout le catalogue gouv.
L'API Adresse normalise une adresse et donne des coordonnées et un code commune. L'API Géo décrit le découpage administratif (communes, EPCI, départements, régions). On les combine souvent : l'adresse donne le citycode, Géo en dérive le territoire. Ce n'est pas l'une ou l'autre.
Non. L'autocomplétion d'adresse, l'API Géo, une partie du cadastre et de la météo s'utilisent sans ce parcours. API Particulier et certaines API sociales l'exigent. Le cadrage commence par cette question, parce qu'elle décide du délai avant le premier flux, bien plus que le développement.
Dégrader. Saisie manuelle, dernière valeur connue, message clair, alerte interne. Un produit qui ne sait que « 502 » sur un formulaire d'inscription perd des utilisateurs pour une cause hors de votre contrôle. Cette dégradation se dessine au cadrage, elle ne s'improvise pas le jour de l'incident.
Quelle API gouv votre parcours appelle-t-il vraiment ?
30 minutes pour lister Adresse, Géo, Particulier ou une autre source, le Datapass éventuel, et le repli si elle tombe.
Parler de mon projet open data