Créer un token API (espace développeur)

Q: Créer un token API (espace développeur)

Créez un token d'API depuis l'onglet Développeur : nom, date d'expiration, permissions read/write/delete par module, et bonnes pratiques de sécurité.

Les tokens API permettent à vos outils (intégrations, scripts, CLI Vysion) d'accéder à vos données via l'API publique de Vysion, avec des permissions limitées à ce dont ils ont besoin.

🔑 Accéder à l'espace développeur

1️⃣ Connectez-vous sur app.vysion.cloud et cliquez sur la flèche en haut à droite

2️⃣ Ouvrez l'onglet Développeur

ℹ️ Cet espace est réservé aux associés.

➕ Créer un token API

1️⃣ Cliquez sur Créer un token API : un volet s'ouvre à droite

2️⃣ Donnez un nom au token (ex. Intégration production)

3️⃣ Choisissez une date d'expiration — 90 jours sont proposés par défaut. Cliquez sur la croix à côté du champ pour créer un token sans expiration

4️⃣ Réglez les permissions, puis enregistrez

🔐 Régler les permissions par module

Le tableau Tous les modules liste les modules accessibles par l'API, regroupés par domaine : Paramétrage, Banques, Ventes, Caisses, Achats / NDFs, Trésorerie, Comptabilité.

Trois permissions par module : read (lecture), write (écriture), delete (suppression).
Par défaut, tous les modules sont en read uniquement.
Les cases d'un groupe ou de l'en-tête cochent/décochent toute la colonne d'un coup ; dépliez un groupe pour régler module par module.

⚠️ Zone de danger. Dès qu'une permission delete est activée, un avertissement s'affiche : toute donnée supprimée via l'API avec ce token sera effacée définitivement. Limitez cette permission aux modules pour lesquels vous en avez réellement besoin.

📋 Copier le token (affiché une seule fois)

Après la création, le token s'affiche une seule fois, avec un bouton Copier le token.

⚠️ Le token ne sera plus visible après la fermeture de cette fenêtre. Copiez-le dès maintenant et enregistrez-le dans un endroit sûr (coffre-fort de mots de passe, gestionnaire de secrets).

🗑️ Supprimer un token

Depuis la liste des tokens, cochez la case du token puis cliquez sur Supprimer le token API.

⚠️ Cette action est irréversible : les intégrations utilisant ce token cesseront de fonctionner.

💻 Et la CLI Vysion ?

Lorsque vous vous authentifiez avec la CLI Vysion, elle crée ce même type de token (vous validez son nom, ses permissions et son expiration dans le navigateur). Il apparaît ensuite dans la liste de l'onglet Développeur, où vous pouvez le supprimer à tout moment.