Créer et gérer des clés d’API pour vos propres systèmes

1. 01

   Vérifier votre formule

   Les clés d’API font partie de l’édition Chain ; voir Formule et facturation. Les clés cessent de fonctionner le jour où un espace de travail quitte Chain. Seules les personnes qui ont l’autorisation de gérer les paramètres de l’espace de travail, comme les propriétaires et les administrateurs, voient Intégrations › API et webhooks.

2. 02

   Créer une clé

   Appuyez sur « Nouvelle clé ». Sous « À quoi sert-elle », donnez-lui le nom du système qui l’utilisera. Sous « Ce à quoi elle peut accéder », cochez seulement ce dont il a besoin, module par module ; « écriture » inclut « lecture ». Si vous ne cochez rien, la clé reçoit votre accès complet.

3. 03

   La copier une fois

   La clé n’apparaît qu’une fois, sous « Votre nouvelle clé ». Copiez-la dans l’autre système. Elle n’est pas conservée dans Setvos et ne peut plus être affichée : une clé perdue se remplace, elle ne se récupère pas.

4. 04

   L’utiliser

   L’encadré indique l’adresse de l’API à laquelle envoyer les requêtes, et « Démarrage rapide API » ouvre notre guide. Une clé agit en votre nom : elle peut faire ce que votre rôle permet, et rien de plus, et elle cesse de fonctionner si vous quittez l’espace de travail. Elle ne travaille que sur les données de l’espace de travail : elle ne peut ni modifier votre compte, ni créer ou remplacer des clés, ni ouvrir quoi que ce soit hors de l’espace de travail. Une clé limitée à certains modules n’atteint qu’eux — ni la recherche, ni les paramètres de l’espace de travail.

5. 05

   Remplacer une clé avant son expiration

   Une clé cesse de fonctionner un an après son émission, et elle est marquée « Expire bientôt » avant cette date. Appuyez sur le bouton « Remplacer la clé » (les flèches en cercle) à côté d’elle : la nouvelle clé garde le nom, la portée et les adresses autorisées, et reste valable un an. Mettez-la dans l’autre système, puis révoquez l’ancienne — ou cochez « Révoquer l’ancienne clé maintenant (ce qui l’utilise encore cessera de fonctionner) ».

6. 06

   Révoquer une clé

   Appuyez sur le bouton « Révoquer » (la corbeille) à côté d’une clé dont vous n’avez plus besoin ou qui a pu fuiter. Setvos demande d’abord confirmation : tapez le nom de la clé et appuyez sur « Révoquer ». La clé cesse immédiatement de fonctionner et ne peut pas être rétablie ; elle reste dans la liste, marquée « Révoquée », pour que son historique soit conservé. Si l’autre système a encore besoin d’un accès, remplacez d’abord la clé.

Mis à jour le 6 octobre 2026