Dokumentation

API-Schlüssel

Erstellen und verwalten Sie API-Schlüssel für den programmatischen Zugriff.

Mit API-Schlüsseln erhalten Sie programmatischen Zugriff auf Ihre Agenten. Nutzen Sie sie, um Agentkit in Ihre Anwendungen zu integrieren oder mit Drittanbieterdiensten zu verbinden.

Hinweis: API-Schlüssel erfordern einen Hobby-Plan oder höher mit aktiver Abrechnung. Free-, überfällige und unbezahlte Workspaces haben keinen Zugriff auf die API. Tarif upgraden →

Einen API-Schlüssel erstellen

  1. Öffnen Sie Ihren Workspace
  2. Klicken Sie in der Seitenleiste auf API-Schlüssel
  3. Klicken Sie auf API-Schlüssel erstellen
  4. Bestätigen Sie im Dialogfeld

Der neue Schlüssel erscheint in der Liste und kann jederzeit angezeigt oder kopiert werden.

Schlüssel anzeigen und kopieren

Jeder Schlüssel in der Liste ist standardmäßig maskiert. Nutzen Sie das Augensymbol, um einen Schlüssel anzuzeigen, und das Kopiersymbol, um ihn in Ihre Zwischenablage zu kopieren.

API-Schlüssel verwenden

Fügen Sie den Schlüssel in API-Anfragen ein:

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"}]}'

Vollständige API-Dokumentation →

Schlüssel verwalten

Alle Schlüssel anzeigen

Alle Schlüssel des Workspace sind auf der Seite API-Schlüssel aufgelistet.

Einen Schlüssel löschen

  1. Suchen Sie den Schlüssel in der Liste
  2. Klicken Sie auf das Papierkorb-Symbol
  3. Bestätigen Sie die Löschung

Gelöschte Schlüssel funktionieren sofort nicht mehr.

Best Practices für die Sicherheit

Schlüssel niemals offenlegen

  • Committen Sie keine Schlüssel in Git-Repositorys
  • Fügen Sie keine Schlüssel in clientseitigen Code ein
  • Verwenden Sie Umgebungsvariablen

Schlüssel regelmäßig rotieren

  • Erstellen Sie regelmäßig neue Schlüssel
  • Aktualisieren Sie Ihre Anwendungen
  • Löschen Sie alte Schlüssel

Separate Schlüssel verwenden

Erstellen Sie unterschiedliche Schlüssel für:

  • Produktion vs. Entwicklung
  • Unterschiedliche Anwendungen
  • Unterschiedliche Teammitglieder oder Dienste

Schlüsselumfang

API-Schlüssel sind an den Workspace gebunden, in dem sie erstellt wurden, und haben Zugriff auf:

  • Alle Agenten im Workspace
  • Chat-API-Endpunkte
  • Webhook-Verwaltung

Schlüssel können nicht:

  • Teammitglieder verwalten
  • Auf die Abrechnung zugreifen
  • Weitere API-Schlüssel erstellen

Zapier-Verbindung

Beim Verbinden mit Zapier:

  1. Erstellen Sie einen dedizierten API-Schlüssel für Zapier
  2. Verwenden Sie diesen Schlüssel in der Zapier-Verbindung
  3. Halten Sie den Schlüssel von anderen Verwendungen getrennt

Zapier einrichten →

Fehlerbehebung

Fehler „Invalid API key“

  • Prüfen Sie, ob der Schlüssel korrekt kopiert wurde
  • Achten Sie auf führende/nachgestellte Leerzeichen
  • Bestätigen Sie, dass der Schlüssel nicht gelöscht wurde

Fehler „Key not authorized“

  • Stellen Sie sicher, dass der Agent zu Ihrem Workspace gehört
  • Prüfen Sie, ob der Workspace des Schlüssels übereinstimmt
  • Bestätigen Sie, dass Ihr Workspace auf Hobby oder höher mit aktiver Abrechnung ist

Schlüssel funktioniert nach dem Erstellen nicht

  • Aktualisieren Sie die Seite
  • Warten Sie 30 Sekunden, bis die Änderung wirksam wird
  • Erstellen Sie einen neuen Schlüssel, falls das Problem weiterhin besteht

Nächste Schritte