
# 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](/docs/api/fapi/front-api-token)).

## İ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:

```json
{"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

```bash
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](/docs/policies/personal-data) 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.
