Bir oturumu alın

GET /v1/sessions/{session_id} · izin sessions:read

Herhangi bir durumdaki (active, expired, revoked) tek bir oturumu döndürür. Tam IP adresi gösterilir ve görünüm yönetim denetim günlüğüne yazılır. Çerezler, belirteçler ve cihaz parmak izleri hiçbir zaman döndürülmez.

İstek

Parametre	Konum	Zorunlu	Açıklama
`session_id`	yol	evet	Oturum kimliği, `ses_` ön ekli.

Yanıt

200 OK. Boş alanlar null olur.

{
  "id": "ses_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "status": "revoked",
  "login_host": "login.example.com",
  "auth_time": "2026-02-01T08:00:00Z",
  "acr": "1fa",
  "amr": ["pwd"],
  "created_at": "2026-02-01T08:00:00Z",
  "last_seen_at": "2026-02-01T09:15:00Z",
  "idle_expires_at": "2026-02-08T09:15:00Z",
  "absolute_expires_at": "2026-03-03T08:00:00Z",
  "org_id": "org_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "ip_address": "203.0.113.10",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0)",
  "revoked_at": "2026-02-01T10:00:00Z",
  "revoke_reason": "admin"
}

revoke_reason yalnızca revoked oturumlarda ayarlanır; örneğin admin, user_logout, idp_logout veya refresh_reuse.

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP	`code`	Ne zaman
404	`not_found`	Oturum bu ortamda yok (veya kimlik biçimi hatalı).
401	`unauthenticated`	API anahtarı eksik, geçersiz veya iptal edilmiş.
403	`insufficient_permissions`	Anahtarın `sessions:read` izni yok.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` değerine uyun.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

curl https://api.eu.keenauth.com/v1/sessions/ses_0a1b2c3d4e5f6g7h8j9k0m1n2p \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth sessions get ses_0a1b2c3d4e5f6g7h8j9k0m1n2p

Kişisel veriler

Bu uç nokta kişisel veri içerir: oturumlar. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.