Clés API

Les clés API donnent aux intégrations externes un accès programmatique aux données de votre espace sans utiliser l'identifiant d'un membre. Réservé aux administrateurs. Chaque clé porte un libellé lisible par l'administrateur (à quoi elle sert) et suit sa date de création + l'horodatage de dernière utilisation pour repérer les clés obsolètes.

Créer une clé

1. Cliquez sur Créer une clé en haut de la page.
2. Saisissez un libellé descriptif — à quoi sert-elle ? Exemples : « Intégration Zapier », « Outil de reporting interne », « Application mobile ».

3. Cliquez sur Créer. La clé n'est affichée qu'une seule fois — copiez-la immédiatement. Vous ne pourrez plus la consulter après fermeture de la bannière.
4. Collez la clé dans votre intégration. Zellbox l'accepte en Authorization: Bearer <key> sur chaque point de terminaison qui accepte l'authentification JWT.

Traitez les clés comme des mots de passe. Quiconque a la clé dispose du même accès aux données que l'administrateur de l'espace. Faites pivoter immédiatement si une clé fuit.

Faire pivoter une clé

Il n'y a pas de rotation sur place. Pour faire pivoter :

1. Créez une nouvelle clé avec le même usage.
2. Mettez à jour votre intégration avec la nouvelle clé.
3. Une fois l'intégration confirmée fonctionnelle, supprimez l'ancienne clé de la liste.

Supprimer une clé

1. Trouvez la clé dans la liste.
2. Cliquez sur Supprimer sur sa ligne.
3. Confirmez dans la boîte de dialogue. La clé est révoquée instantanément — toute requête en cours qui l'utilise commencera à échouer en 401 au prochain appel.