Auth & API-Schlüssel
Bearer-Tokens, Schlüsselrotation, IP-Allowlists und Fehler, die du bei fehlgeschlagener Auth siehst.
Bearer-Tokens
Jede Anfrage an https://api.eveses.com trägt einen API-Schlüssel als Bearer-Token:
Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd
Schlüssel werden unter Account → API Keys erstellt. Behandle sie wie Passwörter — sie geben vollen Zugriff auf Guthaben, Aktivierungen und Mietnummern.
Anlegen
Klicke New key, vergib ein Label (local-dev, ci, production-eu). Das Token wird einmalig beim Anlegen gezeigt — sofort speichern.
Rotieren
Schlüssel sind nicht editierbar. Zum Rotieren: neuen Schlüssel erstellen → in Deployment austauschen → alten löschen. Löschen ist sofort wirksam.
IP-Allowlist
Per-Key-Allowlist: binde einen Schlüssel an bestimmte IPs / CIDR-Bereiche. Anfragen außerhalb der Liste erhalten 403. Konfiguration auf der Schlüssel-Detailseite.
Scopes
Alle Schlüssel haben aktuell vollen Kontozugriff. Scope-Schlüssel (read-only, rentals-only) sind auf der Roadmap.
Fehler
| HTTP | Bedeutung |
|---|---|
| 401 | Fehlender oder fehlerhafter Authorization-Header |
| 403 | Schlüssel widerrufen, Konto gesperrt, oder IP nicht auf Allowlist |
| 429 | Per-Key-Rate-Limit überschritten (Standard 60 rpm) |