Où le trouver
Ouvrez le menu de l’organisation en bas de la barre latérale, cliquez sur Gérer, puis sur l’onglet Paramètres de l’API. Vous voyez vos jetons et un bouton Ajouter un jeton d’API. Toutes les formules incluent des jetons d’API : Free jusqu’à 2, Standard 5, Growth 10, Pro et Enterprise en nombre illimité.Créer un jeton d’API
1
Ouvrir la fenêtre
Cliquez sur Ajouter un jeton d’API (ou sur Créer votre premier jeton si la liste est vide).
2
Nommer le jeton
Saisissez un Nom du jeton *, comme « Intégration WMS » ou « Back-office », pour le reconnaître plus tard. Vous pouvez aussi définir Expire dans (jours) (jusqu’à 365) et, si votre organisation a des marques, Limiter à une marque.
3
Choisir les autorisations
Cochez les Autorisations * dont le jeton a besoin, par exemple Voir les expéditions et Modifier les expéditions.
4
Créer et copier le jeton
Cliquez sur Créer le jeton. Le jeton complet s’affiche une seule fois, dans Jeton d’API créé. Cliquez sur Copier et conservez-le en lieu sûr : vous ne pourrez plus le voir après avoir fermé la fenêtre.
Utiliser le jeton
Votre développeur envoie le jeton dans l’en-têteAuthorization de chaque requête :
Authorization: Bearer YOUR_TOKEN
L’adresse à appeler et chaque requête figurent dans la référence de l’API. Un jeton n’accède qu’aux données de votre propre organisation.
Limiter un jeton à une marque
Si votre organisation utilise des marques, vous pouvez définir Limiter à une marque lors de la création d’un jeton. Chaque requête faite avec ce jeton ne peut alors lire et écrire que les données de cette marque. Vous ne pouvez pas modifier ni retirer la marque ensuite : créez donc un nouveau jeton si vous en avez besoin d’un autre. Un jeton sans marque fonctionne pour toute l’organisation. Un développeur peut quand même cibler une seule marque pour une requête avec l’en-têteX-Zippendo-Brand, et définir une valeur par défaut pour les requêtes de liste avec l’en-tête X-Zippendo-Brand-Scope (own, shared ou both). Voir Marques et la référence de l’API.