À quoi servent les jetons d'accès
Un jeton d'accès (aussi appelé clé API) permet à votre propre logiciel, à un développeur ou à un outil tiers de lire les données de votre boutique via l'API Storeep. Chaque jeton a ses propres autorisations, sa période de données et sa date d'expiration, pour que vous donniez à chaque outil exactement ce dont il a besoin et que vous puissiez le retirer à tout moment sans partager votre mot de passe.
Ouvrez Réglages > Jetons d'accès. Le bouton Voir la documentation ouvre la référence de l'API, avec les endpoints, la façon d'envoyer le jeton et les limites de requêtes. Partagez cette page avec votre développeur.
Vous voulez plutôt connecter un assistant IA comme Claude ou ChatGPT ? Cela n'utilise pas de jetons d'accès. Voir Connecter un assistant IA.
Créer un jeton
Cliquez sur Créer un nouveau jeton, remplissez le formulaire et cliquez sur Créer.
- Nom du jeton : une étiquette pour le reconnaître dans votre liste, par exemple « Synchro comptabilité ». Vous seul la voyez.
- Permissions : cochez-en au moins une :
- Lire les produits : listes de produits, détails, variantes et inventaire.
- Lire les commandes : historique des commandes, détails, statuts et lignes de commande.
- Lire les webhooks : voir les configurations des webhooks et les journaux d'envoi.
- Gérer les webhooks : créer, modifier et supprimer des abonnements webhook via l'API.
- Accès aux données : jusqu'où dans le passé le jeton peut lire.
- Dernières 24 heures : uniquement les données créées au cours des dernières 24 heures. L'option la plus sûre, idéale pour les synchronisations en temps réel.
- Définir la date de début : uniquement les données créées à partir d'une date que vous choisissez dans Date de début d'accès aux données.
- Toujours : toutes vos données, sans limite de date.
- Expiration : N'expire jamais, ou Définir la date d'expiration pour choisir une date jusqu'à un an à l'avance. Après cette date, le jeton cesse de fonctionner tout seul.
Copiez votre jeton maintenant
Après avoir cliqué sur Créer, la fenêtre affiche Votre jeton d'accès avec un bouton de copie. Ce jeton n'est affiché qu'une seule fois. Copiez-le et gardez-le en lieu sûr, par exemple dans un gestionnaire de mots de passe. Storeep ne peut pas l'afficher à nouveau. Si vous le perdez, supprimez le jeton et créez-en un nouveau.
Traitez-le comme un mot de passe. Ne le mettez jamais dans le code d'un site web, dans des dépôts publics, des captures d'écran ou des messages de discussion.
La liste des jetons
- Nom, avec sa date de création.
- Permissions : par exemple Lecture des produits ou Lecture des commandes.
- Accès aux données : Dernières 24 heures, Toutes les données ou De une date.
- Expiration : une date, ou Jamais.
- Dernière utilisation : la dernière fois qu'un outil a utilisé le jeton, ou Jamais.
Il existe un nombre maximal de jetons par boutique. Quand vous l'atteignez, le bouton Créer un nouveau jeton disparaît jusqu'à ce que vous en supprimiez un.
Modifier un jeton
Cliquez sur un jeton pour changer son nom, ses autorisations, son accès aux données ou son expiration. La valeur du jeton reste la même, donc l'outil qui l'utilise continue de fonctionner avec les nouvelles règles.
Supprimer un jeton
Cochez un ou plusieurs jetons et choisissez Supprimer les jetons, ou utilisez le bouton corbeille d'une ligne. Le jeton cesse de fonctionner immédiatement, et tout outil qui l'utilise reçoit une erreur.
Conseils
- Donnez à chaque outil son propre jeton, pour pouvoir en retirer un sans casser les autres.
- Choisissez la plus petite période de données qui convient.
- Fixez une date d'expiration pour les freelances et les missions ponctuelles.
- Un jeton qui affiche Jamais dans Dernière utilisation depuis longtemps n'est probablement pas utile. Supprimez-le.
- Pour que Storeep envoie les événements de commande à votre serveur au lieu que votre serveur les demande, utilisez les webhooks.