Uygulamanın token'larını iptal et
POST /v1/applications/{application_id}/tokens:revoke · izin sessions:write
Uygulamaya verilmiş bütün etkin refresh token ailelerini, bütün kullanıcılar için iptal eder. Çağrıdan önce uygulamaya verilmiş access token'lar introspection ve iptal denetiminde artık kabul edilmez. Uygulamaya verilmiş token'lar sızmış olabileceğinde kullanın: uygulama yeni token'ı yeni bir yetkilendirme isteğiyle almak zorundadır.
Oturumlar, kullanıcıların onayları ve uygulamanın kimlik bilgileri değişmez: kullanıcıların giriş oturumları açık kalır, bu yüzden yeni yetkilendirme isteği yeniden giriş yapmadan başarılı olabilir ve onay yeniden istenmez. Sızan bir client sırrının yeni token almasını durdurmak için uygulamanın kimlik bilgilerini de döndürün. İsteğin gövdesi yoktur. Tekrar çağrı sıfır sayıyla başarılı olur. İptal yönetim audit'ine yazılır. Yeniden denemeleri güvenli kılmak için Idempotency-Key başlığı gönderin.
İstek
| Parametre | Yer | Zorunlu | Açıklama |
|---|---|---|---|
application_id |
path | evet | app_ önekli uygulama kimliği. |
Yanıt
200 OK.
{
"revoked_token_families": 318
}
revoked_token_families bu çağrıda iptal edilen refresh token ailesi sayısıdır.
Hatalar
Her hata, kararlı bir code taşıyan application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 400 | malformed_request, unknown_field |
Gövde gönderildi ve boş JSON nesnesi değil. |
| 404 | not_found |
Uygulama bu ortamda yok. |
| 401 | unauthenticated |
API anahtarı yok, geçersiz ya da iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarda sessions:write 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; sonra yeniden deneyin. |
Örnek
curl -X POST https://api.eu.keenauth.com/v1/applications/app_0a1b2c3d4e5f6g7h8j9k0m1n2p/tokens:revoke \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Idempotency-Key: $(uuidgen)"
CLI: keenauth applications tokens revoke app_0a1b2c3d4e5f6g7h8j9k0m1n2p --yes