Prérequis
Avant de configurer Postman pour l'API V1 de Sellsy, assurez-vous d'avoir :
Postman installé sur votre ordinateur (téléchargeable gratuitement sur postman.com)
Un accÚs API V1 créé dans Sellsy avec vos tokens (Consumer Key, Consumer Secret, Access Token, Token Secret)
La collection API V1 Sellsy (disponible en téléchargement à la fin de cet article)
Bon à savoir : Si vous n'avez pas encore créé d'accÚs API, consultez l'article Types d'accÚs API.
CrĂ©ation dâun environnement API V1
Un environnement Postman permet de stocker vos variables (tokens, URL) pour les rĂ©utiliser facilement dans vos requĂȘtes.
Créer un nouvel environnement
Depuis Postman, cliquez sur "Environments" dans le menu de gauche
Cliquez sur le bouton "New" (ou le symbole +)
SĂ©lectionnez "Environment" dans la fenĂȘtre qui s'affiche
Nommer l'environnement
Nommez l'environnement API V1 pour l'identifier facilement.
Ajouter les variables
Ajoutez les variables suivantes dans votre environnement :
Token consumer : admin_consumer_key admin_consumer_secret
Token utilisateur : admin_access_token admin_token_secret url_base
DĂ©finissiez le type : DĂ©faut
Configurer les variables
Copiez les tokens générés sur Sellsy et collez-les ensuite pour chacune des variables correspondantes (dans "INITIAL VALUE" et "CURRENT VALUE").
Puis dans url_base mettre : https://apifeed.sellsy.com/0/ (dans "INITIAL VALUE" et "CURRENT VALUE").
Ajouter la collection API V1
La collection Sellsy contient des exemples de requĂȘtes prĂȘtes Ă l'emploi pour tester rapidement l'API V1.
Depuis Postman, cliquez sur "Collections" dans le menu de gauche
Cliquez sur "Import"
Cliquez sur "Upload files"
SĂ©lectionnez la collection API V1 Sellsy (fichier JSON) sur votre ordinateur
Cliquez sur "Import"
La collection apparaĂźt maintenant dans votre liste de collections.
Configuration de l'authentification au niveau de la collection
Cliquez sur le document ci-dessous pour consulter le fichier JSON de l'API V1 :