Docs·Auth & API-Schlüssel
🔑

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)