Account en facturering

API-sleutels

Hoe je een API-sleutel aanmaakt, hernoemt, laat verlopen en verwijdert, zodat je de FlowHunt API vanuit je eigen code kunt aanroepen.

Open in ChatGPT Open in Claude

Met een API-sleutel kan een script of applicatie de FlowHunt API namens jouw workspace aanroepen zonder in te loggen. Sleutels horen bij de workspace, niet bij jou persoonlijk, dus aanroepen die ermee worden gedaan, handelen namens die workspace.

Een sleutel aanmaken#

  1. Open het tabblad API Keys

    Klik op Settings in het accountgedeelte en daarna op het tabblad API Keys.

  2. Voeg de sleutel toe

    Klik op Add API Key. Voer in het dialoogvenster Create API Key een Name in die aangeeft waar de sleutel wordt gebruikt, bijvoorbeeld “Nightly export script”. Klik op Add API Key om te bevestigen.

  3. Kopieer hem nu

    Het volgende dialoogvenster toont de sleutel met een knop Copy to clipboard. FlowHunt toont de volledige sleutel slechts één keer en kan hem niet opnieuw tonen. Bewaar hem in een secrets manager of een omgevingsvariabele, nooit in code die je commit.

Als je een sleutel kwijtraakt, maak dan een nieuwe aan en verwijder de oude.

De sleutel gebruiken#

Hetzelfde dialoogvenster heeft Try API key, waarmee je de API-referentie opent op api.flowhunt.io/docs. De referentie bevat alle endpoints en laat zien hoe je de sleutel meestuurt. Een knop PHP SDK verwijst naar het FlowHunt PHP-pakket voor PHP-projecten.

Je sleutels beheren#

De lijst API Keys toont van elke sleutel de Name, een gemaskeerde versie van de sleutel, wanneer hij voor het laatst is gebruikt (Last used) en de datum Valid to.

  • Hernoemen of een vervaldatum instellen. Open een sleutel en wijzig de Name of de datum Valid to en klik vervolgens op Update API Key. De vervaldatum kan alleen na het aanmaken worden ingesteld.
  • Een sleutel verwijderen. Open hem en klik op Remove API Key en bevestig. Alles wat die sleutel nog gebruikt, werkt niet meer.
  • Zoeken. Gebruik het zoekvak boven de lijst om een sleutel te vinden.

Gebruik Last used om sleutels te vinden die niemand meer nodig heeft. Een sleutel die nooit is gebruikt, of maanden niet, is een goede kandidaat om te verwijderen.

Wie kan dit doen#

Owner en Admin kunnen sleutels aanmaken, bewerken en verwijderen. Editor kan de lijst zien en sleutels aanmaken, maar kan ze niet bewerken of verwijderen. Member, Guest en Maintainer zien het tabblad niet. Zie team en rollen.

Je abonnement beperkt niet hoeveel sleutels je aanmaakt. Opgezegde workspaces kunnen geen sleutels aanmaken.

Behandel een sleutel als een wachtwoord

Iedereen die de sleutel heeft, kan de API namens jouw workspace aanroepen. Als een sleutel mogelijk is gelekt, verwijder hem dan uit de lijst en maak een vervanger aan.