🔌 Jetons d'API
Les jetons d'API permettent de connecter BolloPrint à des outils externes comme Make (Integromat), Zapier, vos propres scripts ou tout système ayant besoin de lire ou d'écrire des données de l'atelier sans qu'une personne soit présente.
Ils sont disponibles dans Paramètres → Extensions → Jetons API pour les Admins et les Propriétaires.
L'API est incluse dans les forfaits Max et Business. Si votre forfait ne l'inclut pas, la section apparaît bloquée et les appels avec jeton sont rejetés même si le jeton existe.
Que peut faire une intégration avec un jeton d'API ?
Selon le rôle que vous attribuez au jeton, une intégration peut :
- Créer des commandes automatiquement quand une vente arrive d'une autre plateforme.
- Lire l'état des commandes pour mettre à jour un système de suivi externe.
- Ajouter des clients en masse à partir d'un import.
- Consulter l'inventaire pour des alertes de stock.
Le jeton agit au nom d'un utilisateur « système » de l'atelier, et non d'une personne concrète.
Créer un jeton d'API
- Allez dans Paramètres → Extensions → Jetons API.
- Cliquez sur « Créer un token ».
- Remplissez le formulaire :
- Nom : quelque chose de descriptif pour savoir à quoi il sert (par ex. « Make — commandes web »).
- Rôle : le niveau d'accès du jeton (
admin,workerouviewer). Utilisez le minimum nécessaire. - Expiration : combien de temps le jeton restera actif (1 semaine, 1 mois, 3 mois, 1 an, ou sans expiration).
- Cliquez sur Créer un token.
🔐 Le jeton ne s'affiche qu'une seule fois
Immédiatement après la création du jeton, le système affiche la clé complète. Copiez-la à ce moment-là — elle ne peut plus être consultée. Si vous la perdez, vous devrez créer un nouveau jeton et révoquer l'ancien.
Le jeton commence par bp_tat_
Tous les jetons d'atelier commencent par le préfixe bp_tat_ (BolloPrint Tenant API Token). Il est facile à identifier si vous avez plusieurs jetons dans un gestionnaire de mots de passe.
Rôles du jeton
| Rôle | Ce qu'il peut faire |
|---|---|
admin | Accès complet (lecture et écriture dans tous les modules). |
worker | Équivalent à un Employé : gère les commandes, les clients, le catalogue. |
viewer | Lecture seule. Utile pour les intégrations qui n'ont besoin que de consulter des données. |
Désactiver un jeton
Si vous n'avez plus besoin d'un jeton mais que vous souhaitez conserver l'historique de ce qu'il a fait, utilisez Désactiver. Le jeton cesse de fonctionner mais reste dans la liste.
Si vous voulez le supprimer complètement de la liste, utilisez Supprimer (uniquement disponible pour les jetons déjà désactivés ou expirés).
Audit d'utilisation
Chaque fois qu'une intégration appelle l'API en utilisant un jeton, BolloPrint enregistre l'action dans l'historique de la commande ou du devis qu'elle modifie. À la place du nom d'une personne, vous verrez « API » comme auteur.
Qui peut gérer les jetons d'API ?
Seuls les Admins et les Propriétaires peuvent créer, consulter et révoquer des jetons. Les Employés et les utilisateurs en Lecture seule n'ont pas accès à cette section.