Auth & Sitzung
Diese Endpunkte erfordern eine Benutzersitzung (einen angemeldeten Browser oder dessen JWT).
Raum-API-Tokens können sie nicht aufrufen; ein persönlicher API-Schlüssel darf nur
GET /api/users/me aufrufen.
Die Sitzung gegen ein JWT tauschen
Abschnitt betitelt „Die Sitzung gegen ein JWT tauschen“GET /api/auth/tokenTauscht das OIDC-Sitzungscookie gegen ein kurzlebiges Bearer-JWT.
{ "token": "<jwt>" }Die Sitzung erneuern
Abschnitt betitelt „Die Sitzung erneuern“POST /api/auth/refreshErneuert die OAuth-Sitzung. Die App ruft das automatisch auf.
Aktuelle Sitzung
Abschnitt betitelt „Aktuelle Sitzung“GET /api/sessionLiefert Informationen zur aktuellen Sitzung (Benutzer, Ablauf).
Aktuellen Benutzer registrieren / aktualisieren
Abschnitt betitelt „Aktuellen Benutzer registrieren / aktualisieren“POST /api/auth/userAuthorization: Bearer <jwt>Legt das Benutzerprofil aus dem JWT an oder aktualisiert es. Nebeneffekt: nimmt alle offenen Raumeinladungen an, die zur E-Mail-Adresse des Benutzers passen, und fügt ihn diesen Räumen hinzu.
Aktueller Benutzer & Räume
Abschnitt betitelt „Aktueller Benutzer & Räume“GET /api/users/meGET /api/users/me/roomsGET /api/users/me liefert das Profil samt einem Array rooms; GET /api/users/me/rooms liefert die
Räume, zu denen der Benutzer gehört, mit userRole und Zählwerten.
{ "user": { "userId": "auth0|123456", "email": "user@example.com", "name": "John Doe", "createdAt": 1700000000000, "lastLogin": 1700000000000 }, "rooms": [{ "roomId": "aB3dEfGhIj", "name": "Survey 2026", "memberRole": "owner" }]}Mit einem persönlichen API-Schlüssel (read) antwortet GET /api/users/me
mit { "user": { "userId", "username", "plan" }, "rooms": [...] } — nie mit Ihrer E-Mail-Adresse — und
listet nur die Räume auf der Liste des Schlüssels, falls er eine hat. GET /api/users/me/rooms bleibt
Sitzungen vorbehalten.