auftrag.aiAPI-Key erstellen
Schritt-für-Schritt-Anleitung zur Erstellung eines API-Keys für auftrag.ai
Um die auftrag.ai API zu nutzen, benötigen Sie einen API-Key. Dieser wird in den Entwicklereinstellungen Ihres Accounts erstellt.
Voraussetzungen
- Ein aktives auftrag.ai-Konto unter app.auftrag.ai
- Mindestens die Rolle Administrator
API-Key erstellen
-
Melden Sie sich unter app.auftrag.ai an.
-
Öffnen Sie die Entwicklereinstellungen unter app.auftrag.ai/settings/developer.
-
Klicken Sie auf "API-Key erstellen" und folgen Sie den Anweisungen auf der Seite.
-
Kopieren Sie den generierten API-Key und speichern Sie ihn sicher. Der Key wird nur einmalig vollständig angezeigt.
API-Key verwenden
Übergeben Sie den Key bei jeder API-Anfrage als Bearer Token im Authorization-Header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.auftrag.ai/noticesSicherheitshinweise
Speichern Sie API-Keys niemals im Quellcode, in Repositories oder im Frontend. Verwenden Sie ausschließlich sichere Speicherorte wie Umgebungsvariablen oder einen Secret Manager.
- Rotation: Erneuern Sie API-Keys regelmäßig und deaktivieren Sie nicht mehr benötigte Keys.
- Minimalprinzip: Vergeben Sie nur die Berechtigungen, die für den jeweiligen Anwendungsfall erforderlich sind.
- Überwachung: Prüfen Sie regelmäßig, welche Keys aktiv sind und wann sie zuletzt verwendet wurden.
Fehlerbehebung
| Fehler | Mögliche Ursache | Lösung |
|---|---|---|
401 Unauthorized | Key fehlt oder ist ungültig | Authorization-Header prüfen, Key neu eingeben |
403 Forbidden | Unzureichende Rolle | Administrator-Rolle für den Account sicherstellen |
429 Too Many Requests | Rate-Limit erreicht | Anfragen reduzieren, Retry-After-Header beachten |
Bei Problemen wenden Sie sich an support@auftrag.ai.