Skip to content

Comment publier vos données pour une reprise sur Aides territoires

Sylvain Toé edited this page Jul 22, 2021 · 13 revisions

Cette page est consacrée à l'intégration, sur le site d'Aides Territoires, de données provenant d'organismes partenaires.

Les différentes procédures de publication des données

Les données présentées sur le site Aides Territoires proviennent de plusieurs source :

  1. La saisie manuelle via le formulaire de publication du site.
  2. Des fichiers au format structuré (json, xml) que nous nous chargeons d'importer régulièrement.
  3. L’API de publication pour faire le lien automatique entre les données de nos partenaires et les données d’Aides-territoires.

1. Saisir manuellement les données

Les porteurs d'aides qui souhaitent référencer manuellement leurs dispositifs doivent se créer un compte sur Aides-territoires et saisir les champs du formulaire en ligne : https://aides-territoires.beta.gouv.fr/aides/publier/

2. Importer les données via un fichier json ou xml

L'organisme partenaire publie ses données dans un fichier au format structuré (json, xml) que nous nous chargerons d'importer.

L'équipe technique d'Aides Territoire mets en place le mécanisme d'import qui permet de récupérer les données fournies par le partenaire et de les importer automatiquement dans la base de données.

Le fichier doit :

  • Être publié dans un format structuré (json ou xml) ;
  • Être accessible publiquement (via une url) ;
  • Contenir des données complètes et qualitatives.

Aides-territoires se charge ensuite d'importer ce fichier à intervalle régulier (quotidien, hebdomadaire ou mensuel, en fonction de ce que nous définissons ensemble) pour mettre à jour les données sur Aides-territoires.

Aides-territoires est ici tributaire de la qualité des données que l'organisme partenaire met à disposition. Par ailleurs, nous travaillons avec de nombreux porteurs d'aides, aussi plus nous devons déployer d'effort pour re-traiter les données de chaque porteur, plus cela impacte notre capacité à publier des données complètes et qualitatives, et moins nous sommes en mesure d'assurer notre mission de service au public.

Par conséquent, plus le modèle de données que vous mettrez à disposition se rapprochera du notre, mieux nous pourrons traiter vos données.

3. Utiliser l'API de publication Aides-territoires

Note : API en cours de réflexion, nous contacter pour plus de détails pour voir comment automatiser l'intégration de vos données via une API de publication des aides.