API du marché de l'inclusion

L'API met à disposition le répertoire qualifié des structures d'insertion par l'activité économique.

Documentation

Une documentation est disponible pour explorer et tester les possibilités de l'API. Elle liste aussi les dernières nouveautés.

📚 Accéder à la documentation

Authentification

Certaines données nécessitent un token (jeton utilisateur).

Comment obtenir un token ?

  1. Créez-vous un compte sur le marché de l'inclusion
  2. Puis rendez-vous sur le formulaire de contact pour nous en faire la demande
  3. Une fois généré, le token apparaîtra dans votre espace utilisateur

Comment se servir du token ?

Rien de plus simple, il suffit de rajouter token=<VOTRE-TOKEN> dans l'URL de vos requêtes API

Exemples :
- https://lemarche.inclusion.beta.gouv.fr/api/siae/?token=test
- https://lemarche.inclusion.beta.gouv.fr/api/siae/?department=38&kind=ESAT&token=test

Dernières Nouveautés

Date Version Description
09/11/2021 0.13 - Nouvelle ressource /siae/slug/<slug> pour avoir les détails d'une structure par son slug (champ unique)
- Modifié la ressource /siae/siret/<siret> pour gérer le cas de plusieurs structures partageant le même siret (renvoie une liste dans ce cas là)
- Rajouté le champ id dans les réponses des ressources /siae
02/11/2021 0.12 - Nouvelle ressource /perimeters/autocomplete dédiée à l'auto-complétion des périmètres
- Possibilité de filtrer les structures par réseau
- Ajout de champs supplémentaires dans les détails d'une structure
27/10/2021 0.11 - Migration du marché terminée (l'application et l'API partagent maintenant le même socle technique)
- Les champs sont basculés en anglais pour homogénéiser avec le schéma sous-jacent
- L'url est maintenant finale (sans le sous-domaine api.).
10/2021 0.10 - Possibilité de filtrer les structures par secteur(s) d'activité
10/2021 0.9 - Nouvelle ressource /siae/kinds
- Nouvelle ressource /siae/presta-types
- Possibilité de filtrer les structures par type de prestation
09/2021 0.8 - Nouvelle ressource /networks pour récupérer la liste des réseaux de l'inclusion
09/2021 0.7 - Le site du marché de l'inclusion va prochainement rejoindre le socle technique de l'API
- L'accès à l'API est déplacé dans le sous-dossiers /api
- La ressource secteurs d'activité a été re-architecturé (les données sont désormais mieux représentées)