Passer au contenu principal

Configuration Postman APIV2

Configurez Postman pour l'API V2 de Sellsy : environnement, collection et authentification OAuth 2.0 pour accÚs personnel ou privé.

Mis à jour il y a plus de 2 semaines

Prérequis

Avant de configurer Postman pour l'API V2 de Sellsy, assurez-vous d'avoir :

  • Postman installĂ© sur votre ordinateur (tĂ©lĂ©chargeable gratuitement sur postman.com)

  • Un accĂšs API V2 crĂ©Ă© dans Sellsy (type personnel ou privĂ©)

  • Vos identifiants API (Client ID et Client Secret)

Bon à savoir : Si vous n'avez pas encore créé d'accÚs API, consultez l'article Types d'accÚs API.

Documentation complĂšte : API V2 Sellsy

Paramétrage de Postman

Un environnement Postman permet de stocker vos variables (identifiants, URL) pour les rĂ©utiliser facilement dans vos requĂȘtes.

Créer un nouvel environnement

  1. Depuis Postman, cliquez sur "Environments" dans le menu de droite

  2. Cliquez sur le bouton "New" (ou le symbole +)

  3. SĂ©lectionnez "Environment" dans la fenĂȘtre qui s'affiche

Nommer l'environnement

Nommez l'environnement API V2 pour l'identifier facilement.

Ajouter les variables

Ajoutez les variables suivantes dans votre environnement :

  • url_base

  • sellsyApiHost

  • sellsyAuthorizationHost

  • apiv2_client_id

  • apiv2_client_secret

​DĂ©finissez le type : DĂ©faut

​

Configurer les variables

Copiez les tokens générés sur Sellsy et les coller ensuite pour chacune des variables correspondantes (dans "INITIAL VALUE" et "CURRENT VALUE")

Récupérer vos identifiants API

  1. Rendez-vous dans Sellsy sur "RĂ©glages" > "Portail DĂ©veloppeur" > "API V2"

  2. Copiez votre Client ID et Client Secret

Documentation : Pour plus de détails sur la génération des tokens V2, consultez la documentation API V2.

Configuration pour accÚs privé (optionnel)

Si vous utilisez un accÚs de type privé (au lieu d'un accÚs personnel), vous devez configurer une URL de redirection spécifique.

Modifier l'URL de redirection dans Sellsy :

  1. Depuis Sellsy, accédez à votre accÚs API V2 de type privé

  2. Dans le champ "URL de redirection", renseignez :
    ​https://oauth.pstmn.io/v1/browser-callback

  3. Enregistrez les modifications

Connexion avec un accÚs de type privé (CÎté Postman) :

Création accÚs v2 type privé :

Auth url : https://login.sellsy.com/oauth2/authorization

Access tokens url : https://login.sellsy.com/oauth2/access-tokens

Callback URL : https://oauth.pstmn.io/v1/browser-callback

Ajouter la collection API V2

  1. Depuis Postman, cliquez sur "Collections" dans le menu de gauche

  2. Cliquez sur "Import"

  3. Cliquez sur "Upload files"

  4. SĂ©lectionnez le fichier de la collection API V2 Sellsy (fichier JSON) sur votre ordinateur

  5. Cliquez sur "Import"

Vous pourrez télécharger la collection depuis la page d'accueil de la documentation de l'API V2 :

Vérification des paramétrages des autorisations

  1. ans Postman, cliquez sur la collection "API V2" dans le menu de gauche

  2. Accédez à l'onglet "Authorization"

Pour accĂšs personnel :

Pour accÚs privé :

En dĂ©roulant la collection API V2, vous aurez ensuite l’intĂ©gralitĂ© de toutes les requĂȘtes prĂ©sentes dans la documentation sur l’API V2.

Récupérer des données Postman sous un autre langage

Si pour des besoins spécifiques, vous avez besoin de traduire le code que vous renvoie Postman dans un autre langage, voici comment procéder.

Avez-vous trouvé la réponse à votre question ?