Parola sıfırlamayı zorunlu kıl

POST /v1/users/{user_id}:force-password-reset · izin user-credentials:write

Kullanıcıyı yeni parola seçmeye zorlar: sonraki başarılı parola girişinden sonra yeni parola belirlemeden devam edemez. Mevcut parola özeti silinmez: kullanıcı onunla bir kez daha giriş yapar, ardından yenisini belirler. Yeniden çağırmak güvenlidir: kullanıcı zaten işaretliyse ilk işaretin zamanı korunur. Eylem yönetim audit'ine (user.password_reset_forced) yazılır ve password_reset.scheduled olayını üretir. Çok sayıda kullanıcıyı birden işaretlemek için Toplu parola sıfırlama işi oluştur kullanın.

İstek gövde almaz (gövde göndermeyin ya da {} gönderin). Yeniden denemeleri güvenli kılmak için Idempotency-Key başlığı gönderin.

İstek

Parametre Yer Zorunlu Açıklama
user_id path evet usr_ önekli kullanıcı kimliği.

Yanıt

204 No Content.

Hatalar

Her hata, kararlı bir code taşıyan application/problem+json gövdesidir.

HTTP code Ne zaman
400 malformed_request, unknown_field Gövde geçerli JSON değil ya da bilinmeyen alan içeriyor.
401 unauthenticated API anahtarı yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Anahtarda user-credentials:write izni yok.
404 not_found Kullanıcı bu ortamda yok (ya da kimlik biçimsiz).
409 conflict Kullanıcının parolası 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/users/usr_01h455vb4pex5vsknk084sn02q:force-password-reset \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

CLI: keenauth users force-password-reset usr_01h455vb4pex5vsknk084sn02q