Documentatie

API-sleutels

Genereer en beheer API-sleutels voor programmatische toegang.

API-sleutels maken programmatische toegang tot je agents mogelijk. Gebruik ze om Agentkit te integreren in je eigen applicaties of om externe diensten aan te sluiten.

Let op: Voor API-sleutels is een Hobby-plan of hoger met actieve facturering vereist. Werkruimtes op het Free-plan of met een achterstallige of onbetaalde factuur hebben geen toegang tot de API. Upgrade je plan →

Een API-sleutel aanmaken

  1. Ga naar je werkruimte
  2. Klik op API Keys in de zijbalk
  3. Klik op API-sleutel maken
  4. Bevestig in het dialoogvenster

De nieuwe sleutel verschijnt in de lijst en kan op elk moment worden onthuld of gekopieerd.

Sleutels bekijken en kopiëren

Elke sleutel in de lijst is standaard gemaskeerd. Gebruik het oogicoon om een sleutel te onthullen en het kopieericoon om hem naar je klembord te kopiëren.

API-sleutels gebruiken

Neem de sleutel op in je API-aanroepen:

curl -X POST 'https://your-domain.com/api/v1/chat' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chatbotId": "uuid", "messages": [{"role": "user", "content": "Hello"}]}'

Volledige API-documentatie →

Sleutels beheren

Alle sleutels bekijken

Alle API-sleutels van de werkruimte staan vermeld op de pagina API Keys.

Een sleutel verwijderen

  1. Zoek de sleutel in de lijst
  2. Klik op het prullenbakicoon
  3. Bevestig de verwijdering

Verwijderde sleutels stoppen direct met werken.

Best practices voor beveiliging

Sleutels nooit blootstellen

  • Commit geen sleutels naar git-repositories
  • Neem geen sleutels op in client-side code
  • Gebruik omgevingsvariabelen

Roteer sleutels periodiek

  • Maak periodiek nieuwe sleutels aan
  • Werk je applicaties bij
  • Verwijder oude sleutels

Gebruik gescheiden sleutels

Maak aparte sleutels voor:

  • Productie versus ontwikkeling
  • Verschillende applicaties
  • Verschillende teamleden of diensten

Reikwijdte van sleutels

API-sleutels zijn gebonden aan de werkruimte waarin ze zijn aangemaakt en hebben toegang tot:

  • Alle agents in de werkruimte
  • Chat-API-endpoints
  • Webhookbeheer

Sleutels kunnen niet:

  • Teamleden beheren
  • Facturering inzien
  • Andere API-sleutels aanmaken

Zapier-koppeling

Bij het koppelen met Zapier:

  1. Maak een aparte API-sleutel voor Zapier
  2. Gebruik deze sleutel in de Zapier-koppeling
  3. Houd de sleutel gescheiden van ander gebruik

Zapier instellen →

Problemen oplossen

Foutmelding "Invalid API key"

  • Controleer of de sleutel correct is gekopieerd
  • Let op spaties aan het begin of einde
  • Bevestig dat de sleutel niet verwijderd is

Foutmelding "Key not authorized"

  • Zorg dat de agent bij je werkruimte hoort
  • Controleer of de werkruimte van de sleutel overeenkomt
  • Bevestig dat je werkruimte op Hobby of hoger staat met actieve facturering

Sleutel werkt niet na aanmaak

  • Ververs de pagina
  • Wacht 30 seconden totdat de sleutel actief wordt
  • Maak een nieuwe sleutel aan als het probleem blijft bestaan

Volgende stappen