Kullanıcının onayını iptal et
DELETE /v1/users/{user_id}/consents/{consent_id} · izin users:write
Kullanıcının bir uygulamaya verdiği OAuth onayını iptal eder. Kullanıcının o uygulama için yenileme jetonu aileleri iptal edilir, çağrıdan önce verilmiş erişim jetonları introspection ve iptal denetiminde kabul edilmez hale gelir ve uygulamanın bir sonraki yetkilendirme isteğinde kullanıcıdan yeniden onay istenir. Kullanıcının oturumları ve diğer uygulamaları etkilenmez. İptal işlemi yönetim denetim günlüğüne consent.revoked olarak yazılır.
Zaten iptal edilmiş bir onayı iptal etmek 404 döndürür.
İstek
| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
user_id |
path | evet | usr_ önekli kullanıcı kimliği. |
consent_id |
path | evet | cns_ önekli onay kimliği (Kullanıcının onaylarını listele bölümünden alınır). |
Yanıt
204 No Content.
Hatalar
Her hata, kararlı bir code değeri içeren bir application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 404 | not_found |
Kullanıcı bu ortamda yoksa veya onay yoksa, başka bir kullanıcıya aitse ya da zaten iptal edilmişse. |
| 401 | unauthenticated |
API anahtarı eksik, geçersiz veya iptal edilmişse. |
| 403 | insufficient_permissions |
Anahtarda users:write izni yoksa. |
| 429 | rate_limited |
Hız sınırı aşıldıysa; Retry-After değerine uyun. |
| 503 | service_unavailable |
Bir bağımlılık geçici olarak kullanılamıyorsa; daha sonra yeniden deneyin. |
Örnek
curl -X DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/consents/cns_01jb2k8m5c3f6t9w2y4b7d0g3k \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth users consents delete usr_0a1b2c3d4e5f6g7h8j9k0m1n2p cns_01jb2k8m5c3f6t9w2y4b7d0g3k --yes
Kişisel veriler
Bu uç nokta kişisel veri içerir: onay kayıtları. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süreyle tutulduğu ve nasıl silindiği açıklanır. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.