Bir oturumdan çıkış yap
POST /fapi/v1/me/sessions/{session_id}:revoke · ortamın oturum açma ana bilgisayarından çağrılır
Kimliği doğrulanmış kullanıcının diğer oturumlarından birini sonlandırır. Bu oturumun yenileme belirteçleri iptal edilir, oturumun verdiği erişim belirteçleri reddedilir ve bu oturum üzerinden oturum açmış uygulamalara bildirim gönderilir. İsteği yapan oturum burada sonlandırılamaz; bu tarayıcıdan çıkış yapmak için, çerezi de temizleyen çıkış uç noktasını (/oauth2/logout) kullanın. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gerekir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner. Farklı bir kaynaktaki birinci taraf uygulama bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön yüz API erişim belirteci). Oturumun son 300 saniye içinde doğrulanmış olması gerekir; aksi halde RFC 9470 WWW-Authenticate sorgusuyla (max_age=300) 401 step_up_required yanıtı döner ve hiçbir şey değişmez. Yeniden giriş yapın (örneğin max_age=0 veya prompt=login ile) ve isteği tekrarlayın. Kullanıcının zaten sonlanmış bir oturumu için yanıt 204 olur ve hiçbir şey değişmez.
İstek
Başlıklar:
| Başlık | Gerekli | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet | Tam olarak https://<oturum açma ana bilgisayarı> olmalıdır. |
session_id: GET /fapi/v1/me/sessions tarafından döndürülen oturum tanımlayıcısı (ses_…).
Gövde yok.
Yanıt
204 No Content.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli oturum çerezi yok. |
| 401 | step_up_required |
Oturum 300 saniyeden daha önce doğrulanmış. |
| 403 | origin_not_allowed |
Origin eksik veya yanlış. |
| 404 | not_found |
Bu kullanıcı için böyle bir oturum yok (bilinmeyen, hatalı biçimli veya başka bir kullanıcıya ait tanımlayıcı aynı yanıtı verir). |
| 409 | conflict |
Tanımlayıcı, isteği yapan oturuma ait. |
Örnek
curl -X POST https://example.keenauth.app/fapi/v1/me/sessions/ses_01jbz6x8kq3m2n4p5r6s7t8v9w:revoke \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt