Kullanıcının kilidini aç
POST /v1/users/{user_id}:unlock · izin user-credentials:write
Bir kullanıcının tüm giriş yollarındaki açık hesap kilitlerinin tümünü kaldırır ve başarısızlık sayaçlarını sıfırdan başlatır. Kaldırılan her kilit için user.unlocked olayı (by = admin) yazılır; yönetim denetim kaydı (user.unlocked) kaldırılan kilitleri listeler ve işlemi yapan aktör sizin kimlik bilginizdir. Açık kilidi olmayan bir kullanıcı unlocked: 0 alır ve hiçbir kayıt yazılmaz; bu nedenle çağrıyı güvenle tekrarlayabilirsiniz. Tek bir kilidi kaldırmak için DELETE /v1/attack-protection/lockouts/{lockout_id} kullanın.
İstek
| Parametre | Yer | Zorunlu | Açıklama |
|---|---|---|---|
user_id |
yol | evet | Kullanıcı kimliği, usr_ önekli. |
İşlemin gövdesi yoktur.
Yanıt
200 OK.
{"unlocked": 2}
unlocked, kaldırılan kilit sayısıdır (giriş yolu başına en fazla bir).
Hatalar
Her hata, bir application/problem+json gövdesidir ve kararlı bir code taşır.
| HTTP | code |
Ne zaman |
|---|---|---|
| 404 | not_found |
Kullanıcı bu ortamda yok (ya da kimlik biçimsiz). |
| 401 | unauthenticated |
API anahtarı yok, geçersiz ya da iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarda user-credentials: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; daha sonra yeniden deneyin. |
Örnek
curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p:unlock \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth users unlock usr_0a1b2c3d4e5f6g7h8j9k0m1n2p