Accéder aux données
Plus de 80 000 structures et 100 000 services d'insertion
enrichis quotidiennement à l'échelle locale ou nationale
et relevant de 19 thématiques différentes.
Il existe deux moyens d'accéder aux données data·inclusion présentés dans les onglets ci-dessous :
- en se connectant à l'API data·inclusion ;
- en téléchargeant les fichiers de données ouvertes.
Qu'est ce qu'une API ?
Une "Application Programming Interface" permet à un ordinateur de demander une information à un autre ordinateur, par internet.
Par exemple, l'API data·inclusion permet à un annuaire numérique comme DORA de récupérer toutes les offres de mobilité solidaire d'un territoire et de les proposer à ses utilisateurs.
La connexion à l'API nécessite des compétences techniques de programmation informatique.
Pourquoi utiliser l'API ?
- Des données fraiches : mises à jour régulièrement, au maximum toutes les heures, et accessibles en temps réel.
- Des données exclusives : les coordonnées des référents des offres de service sont disponibles exclusivement sur l'API par mesure de confidentialité.
- Des fonctionnalités supplémentaires : recherche de services par adresse, score de qualité, système de déduplication...
Comment ça marche ?
Remplissez le formulaire de demande d'accès
L'API est en accès restreint car elle contient des données sensibles. Si votre cas d'usage est conforme à nos conditions d'utilisation, nous vous enverrons deux tokens d'authentification différents pour les environnements de recette et de production.
Première étape
Étudiez nos schémas de données
Avant de récupérer les données, nous vous recommandons de consulter la documentation de nos schémas de données structures et services. Vous aurez probablement besoin de faire des correspondances avec votre logique applicative.
Deuxième étape
Utilisez les routes API qui vous conviennent
Enfin, rendez-vous sur la documentation de nos routes API pour choisir celles qui conviennent à votre application. Il en existe plusieurs, dédiées aux structures ou aux services qui ont des finalités différentes.
Attention, il est obligatoire de faire un appel aux routes "détailler un service" ou "détailler une structure" lorsque vos utilisateurs cliquent sur une donnée data·inclusion.
Troisième étape
Données ouvertes (open data)
Ce sont des données numériques produites par les acteurs publics et privés, diffusées de manière structurée selon une licence ouverte garantissant leur libre accès et leur réutilisation par tous, sans restriction technique, juridique ou financière.
Quelle est la différence avec l'API ?
- L'accès est libre car les fichiers ne contiennent pas de données sensibles
- Les fichiers sont mis à jour hebdomadairement, tous les lundi soirs
- Les fichiers n'embarquent pas certaines fonctionnalités de l'API comme le score de qualité, la déduplication de données...
Comment ça marche ?
Téléchargez les fichiers sur le site data.gouv.fr
Nos fichiers de données ouvertes sont hébergés sur data.gouv.fr. Ils sont déposés chaque lundi sous format excel, csv et json.
Première étape
Étudiez nos schémas de données
Avant d'intégrer les données, nous vous recommandons de consulter la documentation de nos schémas de données structures et services. Vous aurez probablement besoin de faire des correspondances avec votre logique applicative.
Deuxième étape
Intégrez les données où vous le souhaitez
Vous êtes libres de stocker, modifier, utiliser les données selon votre besoin. Au clic sur cette carte, vous trouverez des cas d'usage intéressants de nos partenaires.
Troisième étape