API

Intégration API data.gouv.fr : alimentez vos applications en données publiques

Dawap relie les ressources data.gouv.fr à vos applications et outils de gestion. Nous développons la collecte, les contrôles et les mises à jour avec votre DSI. Les sources, les transformations et les anomalies restent identifiables pour réduire les manipulations manuelles.

APIs, données et infrastructures que nos projets savent connecter
Conception, intégration et maintenance
01 Contrat versionné
02 Sécurité explicite
03 Reprise testée
04 Supervision avec alertes

Les interfaces à distinguer

Le catalogue décrit les ressources ; leur contenu se récupère selon la source.

L’API catalogue fournit les fiches, les métadonnées et les liens vers les ressources. Le contenu peut provenir d’un fichier, d’une API du producteur ou de l’API tabulaire lorsque la ressource y est disponible. Nous choisissons le mode de collecte après vérification du jeu concerné.

  • Identifier le producteur, le jeu et la ressource exacte.
  • Vérifier le format, les conditions de réutilisation et la mise à jour.
  • Définir les contrôles avant diffusion dans vos outils.

Incidents à résoudre

Une mise à jour publique ne doit pas désorganiser vos données métier.

Le connecteur vérifie le contenu avant de le transmettre. Une collecte réussie ne signifie pas que le fichier peut être utilisé sans contrôle.

01 Structure

Une colonne change et l’import ne correspond plus au modèle

Les champs, types et identifiants attendus sont contrôlés. Une anomalie bloque la diffusion concernée et permet d’examiner le fichier reçu.

02 Actualisation

Le téléchargement réussit, mais les données restent anciennes

La date de collecte est distinguée de la date des données. Le suivi signale une source qui dépasse le délai convenu.

03 Rapprochement

Un même libellé désigne plusieurs objets

Les correspondances utilisent les identifiants disponibles et des règles explicites. Les cas ambigus sont isolés au lieu d’être rattachés arbitrairement.

Développements data.gouv.fr

De la ressource publique à votre application

Le périmètre dépend des jeux retenus, des données nécessaires et des interfaces de vos outils.

01 · data.gouv.fr

Sélection des ressources

Identifier les jeux et producteurs utiles, la licence, la couverture, les formats et la fréquence de publication annoncée.

02 · data.gouv.fr

Collecte des données

Récupérer le contenu par fichier ou interface disponible, en conservant la référence de la ressource et le résultat du traitement.

03 · data.gouv.fr

Contrôle avant import

Vérifier les colonnes, types, identifiants, valeurs manquantes et volumes selon les règles définies avec vos équipes.

04 · data.gouv.fr

Transformation et correspondances

Adapter les formats et rapprocher les données publiques de vos référentiels, avec un traitement séparé des rejets.

05 · data.gouv.fr

Alimentation de vos logiciels

Charger les données validées dans un entrepôt analytique, une application métier ou un portail, ou les exposer par une API interne.

06 · data.gouv.fr

Suivi des mises à jour

Retrouver la source, la collecte et la transformation utilisées. Alerter en cas de retard, de disparition ou de changement inattendu.

Méthode

Définir d’abord les données nécessaires à votre usage

Un jeu prioritaire et un outil destinataire suffisent pour préciser la collecte, les contrôles et la réception. Nous étendons ensuite le périmètre avec les mêmes règles de traçabilité.

01

Choisir la source

Vérifier son contenu, ses conditions de réutilisation et sa fréquence.

02

Définir les contrôles

Convenir des champs, identifiants et écarts acceptables.

03

Développer les échanges

Récupérer, transformer et diffuser les données validées.

04

Organiser le suivi

Documenter les alertes, corrections et changements de source.

Démarrer le projet

Automatisez un premier jeu de données utile à vos équipes.

Présentez le fichier utilisé, les corrections effectuées et le logiciel à alimenter. Nous préciserons le développement, les contrôles et la maintenance.

Le périmètre à définir

01

Source Jeu, ressource, producteur et conditions de réutilisation.

02

Collecte Interface, fréquence et conservation des versions utiles.

03

Import Correspondances, règles qualité et données rejetées.

04

Exploitation Alertes, responsables et procédure de reprise.

Recette des échanges

Trois situations à prévoir avant l’automatisation

Les exemples suivants servent à définir le comportement de votre connecteur ; ils ne supposent pas que toutes les ressources suivent les mêmes règles.

01 · Fichier

Le nouveau fichier contient moins de lignes que prévu

Une baisse inhabituelle déclenche le contrôle convenu avant de remplacer les données utilisées par l’application.

Entrée
Volumes attendus, règles de suppression et tolérances.
Sortie
Une validation avant publication du nouvel import.
Décision
Publier le résultat ou demander une vérification.
02 · Source

La ressource disparaît ou son lien change

L’erreur reste visible et le connecteur ne substitue pas un autre jeu sans validation. Le comportement de l’application est défini selon le besoin.

Entrée
Références, disponibilité et exigences d’actualisation.
Sortie
Une alerte avec la ressource et le traitement concernés.
Décision
Corriger la source ou adapter le service.
03 · Correspondance

Une donnée publique ne trouve pas sa référence interne

Le rejet est conservé avec son motif. Les données déjà validées et les cas à corriger restent distingués.

Entrée
Clés de rapprochement et règles de création.
Sortie
Une liste des correspondances à examiner.
Décision
Corriger la correspondance avant reprise.
Projet de données publiques

Attractivité Locale : relier référentiels territoriaux et application

Dawap a intégré les régions, départements, EPCI et communes depuis geo.api.gouv.fr à un portail territorial. Ce cas illustre le travail sur les référentiels publics et les objets métier ; il ne constitue pas une intégration de l’API catalogue data.gouv.fr.

Portail économique Attractivité-locale.fr reliant territoire, entreprises et données publiques Intégration API Attractivité-locale.fr : portail économique territorial et API Voir le projet
  • 17 janvier 2025
  • Lecture ~19 min

Attractivité-locale.fr transforme un portail de collectivité en point d’entrée vers les entreprises, leurs offres d’emploi et leur carte OpenStreetMap. Dawap a relié le référentiel géographique de l’État, un back-office multi-rôles et treize routes API de lecture, sans confondre données territoriales et données d’entreprise.

Guide technique

Préparer la collecte des données publiques

Un complément pour examiner les ressources, leurs métadonnées et leur actualisation.

Questions fréquentes

Questions sur l’intégration data.gouv.fr

Sources, collecte, qualité et maintenance : les points à préciser avant le développement.

01L’API catalogue renvoie-t-elle toutes les lignes des jeux de données ?

L’API catalogue permet de retrouver les fiches, les métadonnées et les ressources associées. La lecture du contenu relève ensuite du fichier, d’une API du producteur ou de l’API tabulaire lorsque la ressource y est disponible. Le projet distingue ces accès.

02Quand utilisez-vous l’API tabulaire ?

Elle permet de lire les données de ressources tabulaires prises en charge, avec pagination, filtres et tris. Nous vérifions la disponibilité de la ressource et les limites applicables. Sa présence dans le catalogue ne suffit pas à garantir son accès par cette API.

03Pouvez-vous automatiser un téléchargement de fichier ?

Oui, après vérification de la ressource et de ses conditions de réutilisation. Le traitement contrôle le fichier reçu, conserve les informations utiles à sa traçabilité et prépare les données pour votre logiciel.

04Comment gérez-vous les modifications de colonnes ?

Les champs et types attendus font partie des contrôles. Une modification incompatible est signalée avant diffusion. Nous examinons ensuite la source et adaptons la transformation avec une nouvelle recette.

05Comment savoir si les données sont à jour ?

Le suivi distingue la collecte, la mise à jour de la ressource et la période couverte par les données lorsque ces informations existent. Un seuil d’alerte est défini selon votre usage ; une importation quotidienne ne rend pas plus récent un jeu publié annuellement.

06Peut-on alimenter un entrepôt de données ou une API interne ?

Oui. Nous préparons les tables, correspondances ou réponses API nécessaires à votre outil. Les règles d’actualisation et la provenance sont conservées pour comprendre quelle version alimente le résultat.

07Pouvez-vous reprendre un script de collecte existant ?

Nous examinons les sources, le code, les transformations et les incidents. Les éléments adaptés sont conservés ; les corrections portent sur les dépendances, les contrôles, le suivi et les reprises manquantes.

08Que comprend la maintenance ?

Le périmètre précise les sources suivies, les alertes, les délais d’intervention et les changements pris en charge. Les modifications du producteur restent des événements à analyser ; aucune stabilité universelle des ressources publiques n’est supposée.

Intégration API data.gouv.fr

Intégrez les données publiques aux outils de votre entreprise.

Présentez vos sources, vos imports actuels et le résultat attendu. Nous définirons une première connexion avec les contrôles et la maintenance nécessaires.

Étudier mon intégration open data