h1. 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.

h2. 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)

h2. 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.

h2. Endpoints

h3. associations

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

h3. document

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

h3. document_association

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

h3. documents_associations

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

h3. effectifs_annuels_acoss_covid

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

h3. entreprise_effectifs_mensuels_acoss_covid

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

h3. entreprises

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

h3. etablissement_effectifs_mensuels_acoss_covid

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

h3. etablissements

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

h3. exercices

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

h3. extraits_rcs

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