Suivez les étapes ci-dessous pour configurer vos identifiants API. Cette fonctionnalité n'est pas activée par défaut pour tous les comptes. Si vous n'y avez pas accès et souhaitez en bénéficier, merci d'en discuter avec votre Account Manager.
Vous trouverez dessous la collection Postman permettant de générer le token d'accès à votre instance:
APIs CalcuQuote actuellement disponibles
Amérique du Nord et Amérique du Sud : https://apius.calcuquote.com/swagger
Europe, Moyen-Orient, Afrique, Asie et Australie : https://apieu.calcuquote.com/swagger/
Étapes côté client
Accédez au menu Configuration, puis cliquez sur Integrations.
Cliquez sur le bouton + à côté de CQ API Applications.
Saisissez un nom pour l'application, puis cliquez sur Save afin d'enregistrer l'application et d'initialiser l'accès à l'API. Lors de cette étape, un Client ID et un Client Secret seront générés. Pensez à les enregistrer, car ils seront nécessaires pour la suite.
Cliquez sur les trois points à côté du nom de l'application.
Cliquez sur Generate Access Token.
Saisissez le Client ID et le Client Secret sur la page suivante, puis cliquez sur Submit.
Un Access Token sera généré. Copiez-le.
Ouvrez le Swagger.
Cliquez sur Authorize et collez le token précédemment copié. Vérifiez que le mot Bearer précède bien le token (exemple :
Bearer eyJhbGciOiJI...).Une fois authentifié, vous pourrez accéder aux différentes catégories d'API disponibles dans Swagger. Chaque endpoint comporte une courte description de sa fonction.
Les trois principaux types de requêtes API
GET : utilisé pour récupérer des données depuis le serveur.
POST : utilisé pour envoyer des données afin de créer une nouvelle ressource.
PUT : utilisé pour mettre à jour ou remplacer une ressource existante.
Pour tester un endpoint :
Renseignez le Client ID dans le champ correspondant.
Saisissez ensuite le Client Code.
Le Client Code correspond au nom de l'instance du client.
3. Cliquez sur Try it out pour exécuter la requête.