Sitzungen auflisten

GET /fapi/v1/me/sessions · wird vom Anmelde-Host der Umgebung aufgerufen

Gibt die aktiven Sitzungen des authentifizierten Benutzers zurück, zuletzt gesehene zuerst. Die Sitzung, die die Anfrage stellt, hat current: true. Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers; fehlt das Cookie, ist es abgelaufen oder widerrufen, wird 401 unauthenticated zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Front-API-Zugriffstoken). Eine erneute Verifizierung ist nicht erforderlich.

Anfrage

Header:

Header Erforderlich Beschreibung
Idp-Client ja SDK-Kennung.

Kein Body.

Antwort

200 OK:

Feld Typ Beschreibung
data[].id string Sitzungskennung (ses_…).
data[].current boolean Ob dies die Sitzung ist, die die Anfrage stellt.
data[].login_host string Anmelde-Host, auf dem die Sitzung eröffnet wurde.
data[].browser_family string Browserfamilie, sofern bekannt.
data[].os_family string Familie des Betriebssystems, sofern bekannt.
data[].device_type string Gerätetyp, sofern bekannt.
data[].country string Land, aus dem die Sitzung eröffnet wurde (ISO 3166-1 alpha-2), sofern bekannt.
data[].ip_address string Zuletzt gesehene IP-Adresse, sonst die, von der die Sitzung eröffnet wurde; fehlt, sobald die Aufbewahrung sie gelöscht hat. Wird nur dem Benutzer selbst angezeigt.
data[].created_at string Zeitpunkt, zu dem die Sitzung eröffnet wurde (RFC 3339, UTC).
data[].last_seen_at string Zeitpunkt, zu dem die Sitzung zuletzt verwendet wurde (RFC 3339, UTC). 
{
  "data": [
    {
      "id": "ses_01jbz6x8kq3m2n4p5r6s7t8v9w",
      "current": true,
      "login_host": "example.keenauth.app",
      "browser_family": "firefox",
      "os_family": "linux",
      "device_type": "desktop",
      "country": "DE",
      "ip_address": "192.0.2.10",
      "created_at": "2026-10-01T09:30:00Z",
      "last_seen_at": "2026-10-12T08:15:00Z"
    }
  ]
}

Fehler

Status Code Wann
401 unauthenticated Kein gültiges Sitzungs-Cookie.

Beispiel

curl https://example.keenauth.app/fapi/v1/me/sessions \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Sitzungen. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).