Produits Entr'ouvert » Passerelle

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