Development #67549
API Entreprise v3 - évolutions
Début:
Echéance:
31 janvier 2023
% réalisé:
0%
Temps estimé:
Patch proposed:
Non
Planning:
Non
Description
Sur la base de https://entreprise.api.gouv.fr/developpeurs/guide-migration
Les changements à implémenter pour la v3 de l'API :- Le jeton est à paramétrer uniquement dans le header de l’appel (Avant : Le jeton JWT pouvait être un paramètre de l’URL d’appel (query parameter))
- les codes d'erreur sont plus complets (message user-friendly, détail, attribut retry_in) (cf lien ci-dessus pour le format)
- le payload de réponse est normalisé et est composée systématiquement de 3 clés : data, link et meta
- le endpoint
/entreprise
est splitté en plusieurs urls (https://entreprise.api.gouv.fr/developpeurs/guide-migration#table-de-correspondance-v-2-v-3) - le endpoint
/etablissement
est séparé en deux selon l'option "diffusible" - le endpoint
/extraits_rcs
change d'url - les endpoints
/association
et/document_association
changent d'url - le endpoint
/effectifs_..._acoss_covid
va avoir une nouvelle API dédiée (non documentée à ce jour, développements en cours : https://entreprise.api.gouv.fr/catalogue/urssaf/effectifs) - le endpoint
/exercices
(chiffres d'affaire) : idem (https://entreprise.api.gouv.fr/catalogue/inpi/comptes_annuels_rncs)
Les autres endpoints de la v3 ne sont actuellement pas présents dans notre connecteur.
Les changements pas forcément à implémenter, mais ce serait un plus :- le recipient devient obligatoire, aujourd'hui on le passe dans l'appel WS, on pourra le déménager dans la config du connecteur, comme champ obligatoire
- pas une nouveauté mais la réponse contient des infos de volumétrie dans le header (https://entreprise.api.gouv.fr/developpeurs#volum%C3%A9trie) qu'il pourrait être intéréssant de récupérer
Demandes liées
Historique
Mis à jour par Thomas Noël il y a plus d'un an
- Echéance mis à 31 janvier 2023
Pour rappel, la V.2 qu'on utilise actuellement ferme le 30 juin 2023. Je pose donc une échéance pour début 2023.
Mis à jour par Emmanuel Cazenave il y a plus d'un an
Le site de l'API v2 : https://v2.entreprise.api.gouv.fr/catalogue/
Mis à jour par Emmanuel Cazenave il y a plus d'un an
- Lié à Development #70425: Permettre de spécifier un indicateur de version dans un endpoint ajouté
Mis à jour par Emmanuel Cazenave il y a plus d'un an
- Lié à Development #70498: api-entreprise : préparer l'arrivée des endpoints v3 ajouté
Mis à jour par Emmanuel Cazenave il y a plus d'un an
- Lié à Development #70607: api-entreprise compatibilité v3 : gérer les documents d'association ajouté
Mis à jour par Emmanuel Cazenave il y a plus d'un an
- Lié à Development #70610: api-entreprise v3 : assurer la compatibilité avec la v2 là où c'est facile ajouté
Mis à jour par Emmanuel Cazenave il y a plus d'un an
- Lié à Development #71903: api-entreprise v3 : assurer la compatibilité avec la v2 là où c'est utilisé ajouté
Mis à jour par Emmanuel Cazenave il y a plus d'un an
- Lié à Development #72961: api-entreprise : utiliser la v3 pour le endoint /entreprises ajouté
Mis à jour par Emmanuel Cazenave il y a environ un an
- Lié à Development #73311: api-entreprise v3 : compatibilité v2, retirer les points dans le code NAF ajouté
Mis à jour par Emmanuel Cazenave il y a environ un an
- Lié à Bug #73443: api-entreprise: v3 vs etablisement ajouté
Mis à jour par Emmanuel Cazenave il y a environ un an
- Lié à Development #75640: api-entreprise : supprimer les endpoints effectifs/covid ajouté
Mis à jour par Emmanuel Cazenave il y a environ un an
- Lié à Development #75621: api-entreprise : utiliser la v3 pour /exercices ajouté
Mis à jour par Emmanuel Cazenave il y a environ un an
- Lié à Development #75641: api-entreprise : utiliser la v3 pour match_mandataire_social ajouté
Mis à jour par Marie Kuntz il y a 10 mois
- Statut changé de Nouveau à Solution déployée
Tous les tickets liés ont été traités, je ferme ici.