ExoConnect sépare le gestionnaire (l'application de bureau) et le service API (ExoServiceApi.exe). Les mises à jour de l'API sont indépendantes : vous pouvez changer de version sans réinstaller ExoConnect.
Fonctionnement#
Le gestionnaire ExoConnect télécharge et stocke les versions de l'API localement. Vous pouvez à tout moment consulter les versions disponibles, lire les notes de changement et basculer d'une version à l'autre.Ajouter de nouvelles fonctionnalités ou endpoints
Corriger des bogues ou failles de sécurité
Ajuster des comportements existants
Introduire, dans certains cas, des ruptures de compatibilité
Étiquettes de version#
Chaque version affiche une ou plusieurs étiquettes qui indiquent son statut :| Étiquette | Signification |
|---|
| 🟢 Active | Version actuellement utilisée par le service API |
| 🟡 Deprecated | Version obsolète, le support sera retiré prochainement |
| 🔴 Rupture de compatibilité | Changements majeurs qui peuvent nécessiter des ajustements dans vos intégrations |
| 🛠️ Hotfix | Correctif de sécurité ou correction urgente |
Les étiquettes s'affichent à droite de chaque version dans le gestionnaire. Consultez systématiquement les notes de version avant toute mise à jour, particulièrement pour les versions marquées « Rupture de compatibilité ».
Mettre à jour la version#
1
Consulter les versions disponibles
Dans ExoConnect, accédez au menu Versions de l'API. Le tableau affiche toutes les versions avec leur date de publication, leurs notes et leur statut.
2
Télécharger la version
Si la version souhaitée n'est pas encore téléchargée, cliquez sur l'icône de téléchargement à gauche de la version.
3
Activer la version
Cliquez sur le bouton Utiliser cette version à côté de la version téléchargée.
4
Redémarrer le service
Confirmez le redémarrage de l'API. Le service s'arrête, charge la nouvelle version et redémarre automatiquement. L'interruption dure quelques secondes.
Avant de passer à une version marquée « Rupture de compatibilité », vérifiez vos scripts et intégrations. Des changements de structure dans les réponses JSON, les noms de champs ou la logique métier peuvent affecter votre flux actuel. Lisez attentivement les notes de version.
Revenir à une version précédente#
Si une mise à jour cause des problèmes, vous pouvez revenir à l'ancienne version à tout moment. Les versions téléchargées restent disponibles localement : il suffit de cliquer sur Utiliser cette version à côté de la version précédente et de confirmer le redémarrage.C'est l'un des avantages de la séparation entre le gestionnaire et le service API : le retour en arrière est rapide et sans risque.
Licences et accès aux mises à jour#
L'accès aux nouvelles versions dépend de votre type de licence :| Type de licence | Accès aux mises à jour |
|---|
| Abonnement actif | Toutes les versions publiées pendant la durée de l'abonnement |
| Perpétuelle avec maintenance | Toutes les versions publiées pendant la durée du contrat de maintenance |
| Perpétuelle sans maintenance | Uniquement les versions publiées avant l'expiration du contrat |
Pour les licences perpétuelles sans maintenance active, aucune version publiée après la date d'expiration ne sera accessible. Contactez votre revendeur pour renouveler votre contrat de maintenance si vous avez besoin des dernières mises à jour.
Notes de version#
Consulter les notes de version
Historique complet des changements par version : nouvelles fonctionnalités, corrections et ruptures de compatibilité.
Besoin d'aide?#
Si vous avez des questions sur la compatibilité entre versions ou sur les étapes de migration, contactez l'équipe de soutien technique : support@exom.ca
Guide de démarrage
L'installation est terminée! Faites votre première requête API en 5 minutes.Retour
Revenir aux clés API. 