Disconnetti una sessione
POST /fapi/v1/me/sessions/{session_id}:revoke · chiamato dall'host di accesso dell'ambiente
Termina una delle altre sessioni dell'utente autenticato. I suoi refresh token vengono revocati, i token di accesso emessi da essa vengono rifiutati, e le applicazioni con cui si era effettuato l'accesso tramite essa ricevono una notifica. La sessione che effettua la richiesta non può essere terminata qui; per disconnetterti da questo browser usa l'endpoint di logout (/oauth2/logout), che cancella anche il cookie. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce 401 unauthenticated. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso API front (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso API front). La sessione deve essere stata verificata negli ultimi 300 secondi; altrimenti la risposta è 401 step_up_required con una sfida WWW-Authenticate secondo RFC 9470 (max_age=300) e non cambia nulla. Accedi di nuovo (ad esempio con max_age=0 o prompt=login) e riprova. Una sessione dell'utente già terminata restituisce 204 e non cambia nulla.
Richiesta
Header:
| Header | Obbligatorio | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<host di accesso>. |
session_id: l'identificatore della sessione restituito da GET /fapi/v1/me/sessions (ses_…).
Nessun corpo.
Risposta
204 No Content.
Errori
| Stato | Codice | Quando |
|---|---|---|
| 401 | unauthenticated |
Nessun cookie di sessione valido. |
| 401 | step_up_required |
La sessione è stata verificata più di 300 secondi fa. |
| 403 | origin_not_allowed |
Origin manca o è errato. |
| 404 | not_found |
Nessuna sessione del genere per questo utente (un identificatore sconosciuto, malformato o di un altro utente riceve la stessa risposta). |
| 409 | conflict |
L'identificatore è quello della sessione che effettua la richiesta. |
Esempio
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