Parolayı değiştirin

POST /fapi/v1/me/password · ortamın giriş ana makinesinden çağrılır

Oturum açmış kullanıcının parolasını değiştirir. Mevcut parola kontrol edilir; yeni parola ortamın parola politikasını, sızıntı kontrolünü ve parola geçmişi kuralını geçmelidir. Başarılı olduğunda kullanıcının diğer tüm oturumları ve yenileme belirteçleri iptal edilir, bu oturum açık kalır ve kullanıcının e-posta adreslerine bir güvenlik bildirimi gönderilir. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gerekir. Farklı bir kökendeki birinci taraf uygulama bunun yerine Front API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Front API erişim belirteci).

İstek

Üstbilgiler:

Üstbilgi	Zorunlu	Açıklama
`Idp-Client`	evet	SDK tanımlayıcısı.
`Origin`	evet	Tam olarak `https://<giriş ana makinesi>` olmalıdır.

Gövde:

{"current_password": "…", "new_password": "…"}

Yanıt

204 No Content.

Hatalar

Durum	Kod	Ne zaman
401	`unauthenticated`	Geçerli oturum çerezi yok.
401	`step_up_required`	Oturum son 5 dakika içinde doğrulanmamış; `WWW-Authenticate` üstbilgisindeki `max_age=300` ile yeniden doğrulayın. Hiçbir şey kontrol edilmez veya sayılmaz.
401	`invalid_credentials`	Mevcut parola yanlış. Tekrarlanan hatalar, oturum açmada olduğu gibi parolayı kilitler.
403	`origin_not_allowed`	`Origin` eksik veya yanlış.
422	`password_policy_violation`	Yeni parola politikayı ihlal ediyor; `errors[]`, `/new_password` için ihlal edilen her kuralı listeler (`too_short`, `too_long`, `context_term`, `custom_term`, `repeated_chars`, `invalid_text`, `reused`).
422	`breached_password`	Yeni parola bilinen bir veri ihlalinde yer alıyor.
503	`temporarily_unavailable`	Sunucu meşgul; `Retry-After` saniyesinden sonra yeniden deneyin.

Örnek

curl -X POST https://example.keenauth.app/fapi/v1/me/password \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/json" \
  -d '{"current_password": "…", "new_password": "…"}' \
  -b cookies.txt

Kişisel veriler

Bu uç nokta kişisel veri içerir: kimlik bilgileri. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.