Option 1: JWT per Login
Melde dich mit E-Mail und Passwort an und erhalte ein Token-Paar: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:token. Er wird nur bei der Erstellung im Klartext ausgegeben, speichere ihn also sicher. Danach nutzt du ihn im Header X-API-TOKEN:
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 liefern404 Not Found.