API Entreprise¶

Le connecteur API Entreprise permet d'interroger un certains nombres d'endpoints de la base d'entreprises et d'associations sur entreprise.api.gouv.fr. Il est nécessaire d'obtenir un token pour utiliser le connecteur. Lors de la demande du connecteur, il est nécessaire de préciser à quels endpoints le token doit accéder.

Paramétrage¶

Le paramétrage doit indiquer :

• le nom donné au connecteur (par ex. API entreprise)
• un slug (par ex. api-entreprise)
• une description
• l'url de l'API : https://entreprise.api.gouv.fr/v2/ (renseigné par défaut)
• le jeton d’accès aux API (API token)
• le bénéficiaire de l’appel (la collectivité qui l'utilise)

V3 à venir en 2022¶

Tableau de correspondance : https://entreprise.api.gouv.fr/developpeurs/guide-migration/#table-de-correspondance-v-2-v-3
Guide de migration : https://entreprise.api.gouv.fr/developpeurs/guide-migration

Avec :

• Des temps de réponses inférieurs (car nous n'avons plus qu'un seul fournisseur par API) ;
• Le périmètre des API est plus clair (les API a contenu multiples, comme l'INSEE, ont été divisées, une table de correspondance visuelle est en pièce jointe) ;
• Les payloads de réponses sont normalisées et accompagnées de métadonnées actionnables faisant des liens entre les différents API (par exemple, appel d'une unité légale, puis appel de son siège social) ;
• La v3 met en place des codes erreurs très précis, parfois spécifiques à une API, documentant finement les problèmes et actionnables par vos logiciels ;

Et aussi :

• toute la documentation disponible dans un Swagger, avec à termes des snippets de code ;
• des nouvelles données : sexe et lieu de naissance des personnes physiques, lieu de naissance des mandataires sociaux ;
• le nouveau site API Entreprise.

Nota : au 25/02/2022, la V3 n'étant pas complètement terminée, les différentes fonctionnalités arriveront au fur et à mesure, notamment les codes d'erreurs qui seront intégrés à la documentation progressivement.

Endpoints¶

associations¶

Récupérer les informations de l’association.

document¶

Récupérer un document de l’association.

document_association¶

Récupérer le plus récent document de l’association du type donné.

documents_associations¶

Récupérer les documents de l’association.

effectifs_annuels_acoss_covid¶

Récupérer les effectifs annuels d’une entreprise.

entreprise_effectifs_mensuels_acoss_covid¶

Récupérer les effectifs mensuels d’une entreprise.

entreprises¶

Récupérer les informations de l’entreprise.

etablissement_effectifs_mensuels_acoss_covid¶

Récupérer les effectifs mensuels d’un établissement.

etablissements¶

Récupérer les informations de l’établissement.

exercices¶

Récupérer les informations financières sur l’établissement (exercices).

extraits_rcs¶

Récupérer les données de l’entreprise (extrait RCS) auprès d’Infogreffe.