API-Referenz

Sitzungen

Aktive Benutzersitzungen anzeigen und verwalten. Nützlich für Auditing und das erzwungene Abmelden bei verdächtigen Aktivitäten.

Sitzungsobjekt

json

{
  "id": "sess_abc123",
  "userId": "usr_abc123",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...",
  "ipAddress": "203.0.113.1",
  "country": "KR",
  "createdAt": "2026-01-15T10:30:00Z",
  "lastActiveAt": "2026-01-15T11:45:00Z",
  "expiresAt": "2026-01-16T10:30:00Z"
}

GET/v1/dashboard/sessions

Aktive Sitzungen auflisten

Listet alle aktiven Sitzungen in Ihrem Projekt auf. Erfordert einen geheimen Schlüssel.

Antwort

json

{
  "sessions": [
    {
      "id": "sess_abc123",
      "userId": "usr_abc123",
      "userAgent": "Chrome/120...",
      "ipAddress": "203.0.113.1",
      "lastActiveAt": "2026-01-15T11:45:00Z"
    }
  ],
  "total": 15
}

GET/v1/dashboard/users/:userId/sessions

Benutzersitzungen auflisten

Listet alle aktiven Sitzungen für einen bestimmten Benutzer auf.

Antwort

json

{ "sessions": [...], "total": 3 }

DELETE/v1/dashboard/sessions/:sessionId

Sitzung widerrufen

Erzwingt die Abmeldung für eine bestimmte Sitzung. Der Benutzer wird auf diesem Gerät sofort abgemeldet.

Antwort

json

{ "success": true }

DELETE/v1/dashboard/users/:userId/sessions

Alle Benutzersitzungen widerrufen

Erzwingt die Abmeldung aller Sitzungen eines bestimmten Benutzers auf allen Geräten.

Antwort

json

{ "revoked": 3 }