Zum Inhalt springen
DE

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.

GET /api/auth/token

Tauscht das OIDC-Sitzungscookie gegen ein kurzlebiges Bearer-JWT.

{ "token": "<jwt>" }
POST /api/auth/refresh

Erneuert die OAuth-Sitzung. Die App ruft das automatisch auf.

GET /api/session

Liefert Informationen zur aktuellen Sitzung (Benutzer, Ablauf).

POST /api/auth/user
Authorization: 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.

GET /api/users/me
GET /api/users/me/rooms

GET /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.