Clés API

Une clé API permet à un script ou à une application d’appeler l’API FlowHunt en tant que votre espace de travail, sans se connecter. Les clés appartiennent à l’espace de travail, et non à vous personnellement : les appels effectués avec une clé agissent donc sur cet espace de travail.

Créer une clé#

1. Ouvrez l’onglet Clés API

   Cliquez sur Paramètres dans la zone du compte, puis sur l’onglet Clés API.

2. Ajoutez la clé

   Cliquez sur Ajouter une clé API. Dans la boîte de dialogue Créer une clé API, saisissez un Nom qui indique où la clé est utilisée, par exemple « Script d’export nocturne ». Cliquez sur Ajouter une clé API pour confirmer.

3. Copiez-la maintenant

   La boîte de dialogue suivante affiche la clé avec un bouton Copier dans le presse-papiers. FlowHunt n’affiche la clé complète qu’une seule fois et ne peut plus la réafficher. Conservez-la dans un gestionnaire de secrets ou une variable d’environnement, jamais dans du code que vous validez.

Si vous perdez une clé, créez-en une nouvelle et supprimez l’ancienne.

Utiliser la clé#

La même boîte de dialogue contient Essayer la clé API, qui ouvre la référence de l’API sur api.flowhunt.io/docs. La référence liste tous les points de terminaison et montre comment envoyer la clé. Un bouton PHP SDK renvoie vers le paquet PHP de FlowHunt pour les projets PHP.

Gérer vos clés#

La liste Clés API affiche le Nom de chaque clé, une version masquée de la clé, sa date de Dernière utilisation et sa date de Validité.

• Renommer ou définir une expiration. Ouvrez une clé et modifiez son Nom ou sa date de Validité, puis cliquez sur Mettre à jour la clé API. La date d’expiration ne peut être définie qu’après la création.
• Supprimer une clé. Ouvrez-la, cliquez sur Supprimer la clé API, puis confirmez. Tout ce qui utilise encore cette clé cessera de fonctionner.
• Rechercher. Utilisez le champ de recherche au-dessus de la liste pour trouver une clé.

Utilisez la Dernière utilisation pour repérer les clés dont plus personne n’a besoin. Une clé jamais utilisée, ou pas depuis des mois, est une bonne candidate à la suppression.

Qui peut le faire#

Le propriétaire (Owner) et l’administrateur (Admin) peuvent créer, modifier et supprimer des clés. L’éditeur (Editor) peut voir la liste et créer des clés, mais ne peut ni les modifier ni les supprimer. Les rôles Membre, Invité et Maintainer ne voient pas l’onglet. Voir équipe et rôles.

Votre forfait ne limite pas le nombre de clés que vous créez. Les espaces de travail annulés ne peuvent pas créer de clés.