API et réutilisation des données

Introduction

Cette page est consacrée à la réutilisation, par des organismes partenaires, des données présentes sur l’API Aides Territoires.

Si vous cherchez plutôt à intégrer vos données, afin qu’elles soient publiées sur le site d’Aides Territoires, vous pouvez consulter la page : Comment publier vos données pour une reprise sur Aides Territoires.

Avertissement

Vous utilisez cette API en accord avec nos conditions d’utilisation.

Licence

Les données présentes sur le site Aides Territoires sont placées sous « Licence Ouverte v2.0 » d’Etalab.

Une description de la licence peut être trouvée sur le site d’Etalab, tandis que le texte de la licence elle-même est disponible sur Github.

Voici un résumé non exhaustif et sans validité juridique du contenu de la licence :

Le « réutilisateur » est libre de réutiliser les données :

de les communiquer, les reproduire, les copier ;
de les adapter, les modifier, les extraire et les transformer, notamment pour créer des « Informations dérivées » ;
de les diffuser, les redistribuer, les publier et les transmettre, de les exploiter à titre commercial, par exemple en les combinant avec d’autres informations, ou en les incluant dans votre propre produit ou application.

Sous réserve de mentionner la paternité de l’information en incluant un lien vers le site d’Aides Territoires et en indiquant la date de la dernière mise à jour de l’information réutilisée.

API

Étape 1 : Récupérer votre clé API

Pour utiliser l’API d’Aides Territoires, créez un compte sur le site, puis rendez-vous dans Mes paramètres → Ma clé API pour obtenir votre clé.

Capture d’écran de la page Ma clé API dans Mes paramètres

Étape 2 : Échanger votre clé API contre un Bearer Token

Dans un terminal, envoyez votre clé API à l’endpoint de connexion :

curl -X POST https://aides-territoires.beta.gouv.fr/api/connexion/ \
  -H "X-AUTH-TOKEN: VOTRE_CLE_API" \
  -H "Content-Type: application/json" \
  -d "{}"

La réponse JSON contient votre Bearer Token dans le champ token :

{ "token": "eyJhbGciOiJSUzI1NiJ9..." }

Étape 3 : Appeler l’API avec le Bearer Token

Ajoutez le Bearer Token dans le header Authorization de chacune de vos requêtes. Exemple pour lister toutes les aides :

curl -X GET https://aides-territoires.beta.gouv.fr/api/aids/all/ \
  -H "Authorization: Bearer VOTRE_BEARER_TOKEN"

Consultez la documentation complète des endpoints disponibles.

⚠️ Le Bearer Token expire au bout de 24h. Passé ce délai, refaites l’étape 2 pour en obtenir un nouveau — votre clé API, elle, ne change pas.

Versionnement

Le site Aides Territoires étant en construction active, il est possible que des changements soient apportés au fonctionnement de l’API.

La version actuelle de l’API est : « 1.8.4 ».

Signaler un problème

Pour poser une question ou signaler un problème, vous pouvez nous contacter via le lien se trouvant dans le pied de page.