API-Schlüssel

Um unsere API zu nutzen, müssen Sie einen API-Schlüssel erstellen.

Sobald Sie Ihren Schlüssel haben, können Sie ihn verwenden, um Ihre Anfragen an unsere API zu authentifizieren.

Mit `curl` können Sie Ihren API-Schlüssel beispielsweise wie folgt verwenden:

export AISH_API_KEY="sk_..."

curl -X 'GET' 'https://api.aish.li/v1/ai/agents?limit=3' \
  -H "X-API-Key: $AISH_API_KEY" \
  | jq .

Ein ähnlicher Befehl wird auch angezeigt, nachdem Sie in der API-Referenz auf Try it out und Execute klicken.

Beachten Sie, dass sich dieser X-API-Key-Header vom Header Authorization: Bearer ... unterscheidet, der ausschließlich für die OAuth2-Token-Authentifizierung in der interaktiven API-Dokumentation verwendet wird. Der Header X-API-Key wird anstelle von OAuth2 für die API-Schlüssel-Authentifizierung von Ihren eigenen Backend-Systemen aus verwendet.

Caution

Ihre API-Schlüssel sind vertraulich und gewähren vollen Zugriff auf Ihr Konto, ohne dass Ihr Anmeldepasswort erforderlich ist – einschließlich Ihrer Agenten, Ihres Sitzungsverlaufs und Ihrer Einstellungen.

  • Teilen Sie Ihren API-Schlüssel niemals öffentlich und committen Sie ihn nicht in Git-Repositories.
  • Betten Sie API-Schlüssel niemals in clientseitiges HTML oder JavaScript ein.
  • Wenn Sie vermuten, dass ein Schlüssel kompromittiert wurde, widerrufen Sie ihn sofort über das Papierkorb-Symbol auf der Seite API-Schlüssel.

API-Schlüssel werden bei der Erstellung nur ein einziges Mal angezeigt. Wenn Sie einen Schlüssel verlieren, müssen Sie einen neuen erstellen.