Table of Contents

Migrations depuis les API V1

La version actuelle des API Cegid Expert, celle concernée par cette documentation est la version n° 2 (ou V2).

Ce changement de version implique des modifications plus ou moins importantes par rapport à la version précédente (V1).

Dédignation des versions

Version 1

La version 1 des API Cegid Expert désigne l'ensemble des API Cegid Expert publiées avant la mise en place de la plateforme d'API Management (APIM) de Cegid.

Elles sont accessibles via les hôtes suivants :

Les liens vers la documentation de ces API V1 est disponible à l'adresse suivante :
https://go.cegid.com/cegid-expert-web-api.html

Du fait de la technologie utilisée pour l'écriture de cette version des API Cegid Expert, elles sont également désignées sous le termes "API 4.8" .

Version 2

La version 2 des API Cegid Expert désigne l'ensemble des API Cegid Expert publiées sur la plateforme d'API Management (APIM) de Cegid.

Elles sont accessibles via les hôtes suivants :

La documentation de ces API est accessible à partir de cette page depuis l'onget "Products" en choisissant le produit "Cegid Expert".
Ou bien directement à cette adresse :
https://developers.cegid.com/product#product=cegid-expert

Du fait de la technologie utilisée pour l'écriture de cette version des API Cegid Expert, elles sont également désignées sous le termes "API Net 8" .

Important

Toutes les API V1 ne sont pas encore disponibles en V2.

Accompagnement à la migration

Pour vous accompagner dans la migration de vos applications utilisant les API V1 vers les API V2, nous mettons à votre disposition des informations de migration.

Pourquoi migrer ?

La migration vers les API V2 vous permettra de bénéficier des avantages suivants :

  • Mise à jour technologique : Les API V2 sont construites sur des technologies plus récentes, offrant de meilleures performances et une meilleure sécurité.
  • Généricité : Les API V2 sont conçues pour être plus génériques et flexibles, facilitant ainsi leur intégration dans divers scénarios d'utilisation tout en éliminant les redondances.
  • Correction des défauts : Les API V2 corrigent certains défauts et limitations présents dans les API V1, offrant une expérience utilisateur améliorée.

Quand migrer ?

Nous vous recommandons de planifier la migration de vos applications vers les API V2 dès que possible, c'est à dire dès que les API V2 nécessaires à vos besoins sont disponibles.

Dès lors qu'une API est disponible en V2, la mention "Utilisable jusqu'au" est ajoutée à la documentation de la version 1 de cette API.
img

L'information d'obsolescence est également visible dans les en-têtes de réponse des appels aux API V1 concernées.

  • Via un champ nommé Deprecation qui indique la date à laquelle la méthode d'API est déclarée obsolète ;
  • Via un champ nommé Sunset qui indique la date à laquelle la méthode d'API ne sera plus accessible.

Par exemple :
Deprecation: Mon, 30 Dec 2024 23:00:00 GMT
Sunset: Thu, 31 Dec 2026 22:59:00 GMT

Note

Il y a généralement un décalage d'une heure entre les dates indiquées dans les en-têtes et celles affichées dans la documentation.
Ceci est dû au fait que les dates dans les en-têtes sont en GMT tandis que celles de la documentation sont en heure locale française (CET/CEST).

Important

Nous laissons un délai de 30 mois entre la date de dépréciation et la date de retrait des API V1.
Passé ce délai, les API V1 ne sont automatiquement plus accessibles.

Comment migrer ?

Pour vous aider dans la migration de vos applications, nous mettons à votre disposition les ressources suivantes :

En complément, dans le détail de chaque API V1 obsolète, vous trouverez un lien vers la documentation de l'API V2 qui la remplace.
img