← Tous les articles

Mettre à jour l’API REST vers une nouvelle version

Chaque version de l’API REST correspond à la version de Sage 50 Édition canadienne qu’elle prend en charge. Pour passer à une nouvelle version, exécutez le nouveau programme d’installation sur le serveur où l’API REST est installée et choisissez de mettre à jour l’installation existante. L’installation la met à jour sur place : l’URL, le pool d’applications IIS et la clé d’API restent les mêmes, et vos applications et clients d’IA continuent de fonctionner sans changement de configuration.

Avant la mise à jour

Lancer le programme d’installation

Windows peut bloquer le programme d’installation la première fois que vous l’exécutez. Si l’écran Windows a protégé votre ordinateur apparaît, cliquez sur Informations complémentaires.

Fenêtre Microsoft Defender SmartScreen indiquant que Windows a protégé votre ordinateur, avec le pointeur sur le lien d'informations complémentaires.
Cliquez sur Informations complémentaires pour afficher les détails de l'application.

Vérifiez que le nom de l’application est bien celui du programme d’installation que nous vous avons envoyé, puis cliquez sur Exécuter quand même.

Fenêtre SmartScreen montrant l'application ArivSageApi-2027.0-26.10.1.exe, avec les boutons pour exécuter quand même ou ne pas exécuter.
Le nom de l'application correspond au fichier d'installation. Cliquez sur Exécuter quand même.

Choisissez la langue de l’installation, français ou anglais, et cliquez sur OK.

Boîte de dialogue Select Setup Language avec la liste des langues sur Français et les boutons OK et Cancel.
Choisissez la langue de l'installation.

Lisez le contrat de licence, sélectionnez Je comprends et j’accepte les termes du contrat de licence, puis cliquez sur Suivant.

Page Accord de licence du programme d'installation montrant les conditions générales, avec l'option d'acceptation sélectionnée.
Acceptez le contrat de licence pour continuer.

L’installation affiche ensuite la page Prérequis pendant qu’elle vérifie les fonctionnalités Windows dont IIS a besoin : Services World Wide Web, Scripts et outils de gestion IIS, Activation HTTP et ASP.NET 4.8. Sur un serveur où l’API REST est déjà installée, ces fonctionnalités sont déjà activées. Attendez la fin de la page. Si Windows demande un redémarrage, redémarrez le serveur et relancez l’installation.

Choisir l’installation à mettre à jour

L’installation demande s’il faut mettre à jour une installation existante ou en créer une nouvelle. Sélectionnez Mettre à jour une installation existante et cliquez sur Suivant.

Page Type d'installation avec Mettre à jour une installation existante sélectionné et Créer une nouvelle installation non sélectionné.
Mettre à jour une installation existante garde son URL et sa clé d'API.

La liste montre chaque installation de l’API REST sur le serveur, par site Web IIS et chemin virtuel. L’installation présélectionne la dernière installée. Sous la liste, vérifiez son URL, son chemin physique et son pool d’applications, puis cliquez sur Suivant.

Page Installation à mettre à jour avec Default Web Site / Sage50RestApi sélectionné, montrant l'URL http://localhost/Sage50RestApi/, le chemin physique et le pool d'applications Ariv.Sage50.Api.
Vérifiez l'URL, le chemin physique et le pool d'applications de l'installation à mettre à jour.

Vérifier les paramètres de l’application

Un avis confirme qu’une installation existante a été détectée à cet emplacement IIS et qu’elle sera mise à jour. Vérifiez le fichier de l’entreprise Sage (.SAI), le nom d’utilisateur Sage et le mot de passe que l’API utilise pour ouvrir le fichier de l’entreprise. Si le fichier de l’entreprise a été déplacé, cliquez sur Parcourir pour le sélectionner. Cliquez sur Suivant.

Page Paramètres de l'application avec un avis indiquant qu'une installation existante a été détectée, et les champs Fichier SAI Sage, Nom d'utilisateur Sage et Mot de passe Sage.
Indiquez le fichier de l'entreprise et l'utilisateur Sage avec lequel l'API se connecte.

Choisir le serveur MCP

Laissez Installer le serveur MCP comme application IIS enfant sous l’API REST (à ai/mcp) sélectionné pour garder ou ajouter le serveur MCP à ai/mcp. Décochez-le pour mettre à jour l’API REST seule. Si le serveur MCP est déjà installé, décocher cette option le supprime. Voir connectez des clients d’IA à Sage 50.

Page Accès MCP Sage avec l'option d'installer le serveur MCP comme application IIS enfant sous l'API REST à ai/mcp sélectionnée.
Le serveur MCP est installé comme application enfant à ai/mcp.

Confirmer l’accès client

Cette version installe des points d’accès HTTP. Cochez la case qui confirme que les clés d’API et les données Sage 50 sont envoyées en clair par HTTP, et que vous êtes responsable de configurer HTTPS dans IIS, les règles de pare-feu et les certificats au besoin. Cliquez sur Suivant.

Page Accès client expliquant que cette version installe des points d'accès HTTP, avec la case de confirmation cochée.
Confirmez que les points d'accès utilisent HTTP.

Lancer la mise à jour

L’installation liste ce qu’elle va faire : mettre à jour les fichiers de l’application, l’application IIS de l’API REST et, si elle est sélectionnée, l’application IIS MCP. Vérifiez le site Web, le chemin et les URL, puis cliquez sur Mettre à jour.

Page Prêt pour la mise à jour listant les actions : mettre à jour les fichiers de l'application dans C:\Program Files\Ariv\Sage50RestApi, l'application IIS de l'API REST à http://localhost/Sage50RestApi/ et l'application IIS MCP à http://localhost/Sage50RestApi/ai/mcp.
Vérifiez les actions, puis cliquez sur Mettre à jour.

Une fois la mise à jour terminée, l’installation affiche l’URL de l’API REST, l’URL MCP et la clé d’API. Elles sont les mêmes qu’avant la mise à jour, donc rien ne change dans vos applications ou vos clients d’IA. Cliquez sur Terminer.

Écran Mise à jour terminée montrant l'URL de l'API REST, l'URL MCP et un champ de clé d'API flouté avec un bouton Copier.
L'URL de l'API REST, l'URL MCP et la clé d'API restent les mêmes après une mise à jour.

Pour mettre à jour l’API REST d’un autre fichier de l’entreprise, exécutez de nouveau l’installation et sélectionnez cette installation.

Vérifier la version installée

Appelez GET /api/database avec votre clé d’API. L’en-tête de réponse Ariv-Product-Version renvoie la version du produit installée, par exemple 26.10.1.

curl -i http://localhost/Sage50RestApi/api/database \
  -H "x-api-key: VOTRE_CLE_API"
HTTP/1.1 200 OK
Ariv-Product-Version: 26.10.1

Ajout ou suppression de programmes affiche aussi la version de Sage 50 et la version du produit, par exemple 2027.0-26.10.1.

Étapes suivantes