Konto und Abrechnung
API-Schlüssel
Wie Sie einen API-Schlüssel erstellen, umbenennen, ablaufen lassen und entfernen, damit Sie die FlowHunt-API aus Ihrem eigenen Code aufrufen können.
Ein API-Schlüssel ermöglicht es einem Skript oder einer Anwendung, die FlowHunt-API als Ihr Workspace aufzurufen, ohne sich anzumelden. Schlüssel gehören zum Workspace, nicht zu Ihnen persönlich, daher wirken damit ausgeführte Aufrufe auf diesen Workspace.
Einen Schlüssel erstellen#
Tab „API-Schlüssel“ öffnen
Klicken Sie im Kontobereich auf Einstellungen und dann auf den Tab API-Schlüssel.
Schlüssel hinzufügen
Klicken Sie auf API-Schlüssel hinzufügen. Geben Sie im Dialog API-Schlüssel erstellen einen Namen ein, der erkennen lässt, wo der Schlüssel verwendet wird, zum Beispiel “Nächtliches Export-Skript”. Klicken Sie zur Bestätigung auf API-Schlüssel hinzufügen.
Jetzt kopieren
Der nächste Dialog zeigt den Schlüssel mit einer Schaltfläche In die Zwischenablage kopieren. FlowHunt zeigt den vollständigen Schlüssel nur einmal und kann ihn nicht erneut anzeigen. Speichern Sie ihn in einem Secrets-Manager oder in einer Umgebungsvariable, niemals in Code, den Sie committen.
Wenn Sie einen Schlüssel verlieren, erstellen Sie einen neuen und entfernen Sie den alten.
Den Schlüssel verwenden#
Derselbe Dialog enthält API-Schlüssel testen, was die API-Referenz unter api.flowhunt.io/docs öffnet. Die Referenz listet jeden Endpunkt auf und zeigt, wie der Schlüssel übermittelt wird. Eine Schaltfläche PHP SDK verlinkt auf das FlowHunt-PHP-Paket für PHP-Projekte.
Ihre Schlüssel verwalten#
Die Liste API-Schlüssel zeigt den Namen jedes Schlüssels, eine maskierte Version des Schlüssels, wann er Zuletzt verwendet wurde und sein Gültig bis-Datum.
- Umbenennen oder Ablauf festlegen. Öffnen Sie einen Schlüssel und ändern Sie seinen Namen oder das Datum Gültig bis, dann klicken Sie auf API-Schlüssel aktualisieren. Das Ablaufdatum kann erst nach der Erstellung festgelegt werden.
- Einen Schlüssel entfernen. Öffnen Sie ihn, klicken Sie auf API-Schlüssel entfernen und bestätigen Sie. Alles, was diesen Schlüssel noch verwendet, funktioniert dann nicht mehr.
- Suchen. Verwenden Sie das Suchfeld über der Liste, um einen Schlüssel zu finden.
Nutzen Sie Zuletzt verwendet, um Schlüssel zu finden, die niemand mehr braucht. Ein Schlüssel, der nie oder seit Monaten nicht verwendet wurde, ist ein guter Kandidat zum Entfernen.
Wer das darf#
Owner und Admin können Schlüssel erstellen, bearbeiten und entfernen. Editor kann die Liste sehen und Schlüssel erstellen, aber nicht bearbeiten oder entfernen. Member, Guest und Maintainer sehen den Tab nicht. Siehe Team und Rollen.
Ihr Tarif begrenzt nicht, wie viele Schlüssel Sie erstellen. Gekündigte Workspaces können keine Schlüssel erstellen.
Behandeln Sie einen Schlüssel wie ein Passwort
Jeder, der den Schlüssel besitzt, kann die API als Ihr Workspace aufrufen. Wenn ein Schlüssel möglicherweise geleakt wurde, entfernen Sie ihn aus der Liste und erstellen Sie einen Ersatz.