Authentifizierung und API-Schlüssel
Wie Sie Ihren API-Schlüssel senden, wie viele Schlüssel Sie haben können, was ein Schlüssel darf und was nicht, was bei einem geleakten Schlüssel zu tun ist und wie Sie einen KI-Assistenten trennen.
Schlüssel im Header Authorization senden
Authorization: Bearer YOUR_API_KEYNur in diesem Header liest die API einen Schlüssel.
- Setzen Sie einen Schlüssel nie in eine URL (
?api_key=…). URLs landen in Logs, im Browserverlauf und in geteilten Links. Die API lehnt eine solche Anfrage mit400 api_key_in_queryab. Betrachten Sie diesen Schlüssel als offengelegt: Widerrufen Sie ihn und erstellen Sie einen neuen. - Rufen Sie genau
https://gloriads.com/api/v1auf: Ein Client, der einer Weiterleitung an eine andere Adresse folgt, verliert unterwegs Ihren Schlüssel. - Rufen Sie die API aus einer Tabelle, einem Skript oder von einem Server auf, nicht aus dem Code einer Webseite: Jeder Besucher der Seite könnte den Schlüssel lesen.
Was ein Schlüssel darf
- Ihr Konto lesen, über jeden Endpunkt.
- Nichts ändern. Die API ist schreibgeschützt.
- Die Limits Ihres Kontos teilen: Alle Ihre Schlüssel und verbundenen KI-Assistenten zählen zusammen, ein zweiter Schlüssel bringt also nicht mehr Anfragen. Siehe Limits und Fehler.
Schlüssel erstellen
Einstellungen → API → Schlüssel erstellen.
- Der Name darf bis zu 40 Zeichen lang sein. Verwenden Sie den Namen des Tools, damit Sie später wissen, welchen Schlüssel Sie widerrufen müssen.
- Der Schlüssel wird einmal angezeigt. Wir speichern nur einen Fingerabdruck davon, sodass niemand ihn erneut anzeigen kann – auch wir nicht. Bewahren Sie ihn in einem Passwortmanager oder in den geheimen Einstellungen Ihres Tools auf.
- Sie können 10 Schlüssel gleichzeitig haben.
- Das öffentliche Demokonto kann keine Schlüssel erstellen.
Die Schlüsselliste
Jeder Schlüssel zeigt seinen Namen, seine ersten Zeichen (key_live_ab12…), wann er
erstellt und wann er zuletzt verwendet wurde.
„Zuletzt verwendet“ wird höchstens einmal pro Stunde aktualisiert. Ein Schlüssel, der vor ein paar Minuten verwendet wurde, kann also noch eine frühere Zeit zeigen.
Schlüssel widerrufen
Öffnen Sie das Menü ⋯ des Schlüssels und dann Widerrufen.
Das gilt sofort: Die nächste Anfrage mit diesem Schlüssel erhält
401 unauthorized, dieselbe Antwort wie für einen Schlüssel, den es nie gab. Ein
widerrufener Schlüssel lässt sich nicht wiederherstellen – erstellen Sie einen
neuen.
KI-Assistenten ohne Schlüssel
claude.ai und ChatGPT verwenden keinen Schlüssel: Sie melden sich aus dem Assistenten heraus bei Gloriads an und klicken auf Zulassen. Der Assistent erhält dann einen eigenen Zugang, der nur lesen kann. So verbinden Sie einen: KI-Assistenten verbinden.
- Einstellungen → API → Verbundene Apps listet jeden Assistenten auf, die Adresse, die den Zugang angefordert hat, wann Sie ihn verbunden haben und wann er Ihr Konto zuletzt gelesen hat (höchstens einmal pro Stunde aktualisiert).
- Nicht verifiziert neben einem Namen bedeutet, dass sich die App selbst registriert hat, ohne ihre Adresse nachzuweisen. Behalten Sie sie nur, wenn Sie sie selbst verbunden haben.
- Um einen zu stoppen, öffnen Sie sein Menü ⋯ und dann Trennen. Das gilt sofort. Um ihn wieder zu verwenden, verbinden Sie ihn erneut aus dem Assistenten.
Wenn eine Anfrage abgelehnt wird
| Antwort | Grund | Was tun |
|---|---|---|
401 unauthorized | Kein Header Authorization, oder ein falscher oder widerrufener Schlüssel | Header und Schlüssel prüfen |
403 subscription_inactive | Ihr Abo ist beendet | Unter Einstellungen → Abrechnung abonnieren |
400 api_key_in_query | Der Schlüssel stand in der URL | In den Header verschieben, dann widerrufen |
Alle anderen Codes werden unter Limits und Fehler beschrieben.
Der öffentliche Demo-Schlüssel
Die API-Referenz füllt ihre Schaltfläche Try it mit einem öffentlichen Schlüssel vor. Er liest nur das Demokonto und ist auf 10 Anfragen pro Minute begrenzt, die sich alle Besucher teilen. Ihr eigenes Konto kann er nicht lesen: Verwenden Sie dafür Ihren eigenen Schlüssel.