Skip to main content
Alle Endpoints außer Login, Registrierung und Passwort-Wiederherstellung erfordern eine Authentifizierung. Du hast zwei Möglichkeiten:

Option 1: JWT per Login

Melde dich mit E-Mail und Passwort an und erhalte ein Token-Paar:
Das token schickst du bei jeder Anfrage im Header Authorization: Bearer <token> mit. Es ist zeitlich begrenzt gültig. Mit dem refresh_token holst du ein neues Token, ohne das Passwort erneut zu senden:
Ist für dein Konto die Zwei-Faktor-Authentifizierung aktiv, liefert POST /auth/login statt des vollständigen Token-Paars ein Vorab-Token (auth_scope: mfa_pending). Bestätige damit den zweiten Faktor über POST /auth/2fa/verify (TOTP- oder Wiederherstellungscode) und erhalte anschließend das reguläre Token-Paar. Alternativ kannst du dich mit einem Passkey über POST /auth/passkeys/login/options und POST /auth/passkeys/login/verify anmelden.

Option 2: Persönlicher API-Token

Für Automatisierungen legst du einen dauerhaften API-Token an. Dafür brauchst du einmalig ein JWT:
Die Antwort enthält den Token im Feld token. Er wird nur bei der Erstellung im Klartext ausgegeben, speichere ihn also sicher. Danach nutzt du ihn im Header X-API-TOKEN:
Über GET /user/api-tokens siehst du alle Tokens deines Benutzers, mit DELETE /user/api-tokens/{id} widerrufst du einen Token sofort.

Berechtigungen

Ein Token handelt immer im Namen des Benutzers, der ihn erzeugt hat, und hat dieselben Rechte wie dieser Benutzer im Kundenpanel. Ressourcen anderer Kunden sind nicht sichtbar und liefern 404 Not Found.
Behandle Tokens wie Passwörter. Lege sie nie in Client-seitigem Code oder öffentlichen Repositories ab. Verwende für jede Anwendung einen eigenen API-Token, damit du ihn einzeln widerrufen kannst.