
# Kurtarma kodlarını yenile

`POST /fapi/v1/me/recovery-codes:regenerate` · ortamın oturum açma ana bilgisayarından çağrılır

Kullanıcının kurtarma kodlarını yenileriyle değiştirir; tüm eski kodlar geçersiz hale gelir. Yeni kodlar yalnızca bu yanıtta bir kez gösterilir 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; çerez yoksa, süresi dolmuşsa veya iptal edilmişse `401 unauthenticated` döner. Farklı bir kaynaktaki birinci taraf uygulama bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte `Authorization: DPoP <token>`; bkz. [Ön yüz API erişim belirteci](/docs/api/fapi/front-api-token)).

## İstek

Başlıklar:

| Başlık | Gerekli | Açıklama |
| --- | --- | --- |
| `Idp-Client` | evet | SDK tanımlayıcısı. |
| `Origin` | evet | Tam olarak `https://<oturum açma ana bilgisayarı>` olmalıdır. |

Gövde:

```json
{}
```

## Yanıt

`200 OK`:

```json
{"recovery_codes": ["…", "…"]}
```

## 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` başlığındaki `max_age=300` ile yeniden doğrulayın. |
| 403 | `origin_not_allowed` | `Origin` eksik veya yanlış. |
| 404 | `not_found` | Kurtarma kodları ortamda devre dışı. |
| 409 | `conflict` | Kullanıcının ikinci faktörü yok; kurtarma kodları üretilmedi. |

## Örnek

```bash
curl -X POST https://example.keenauth.app/fapi/v1/me/recovery-codes:regenerate \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/json" \
  -d '{}' \
  -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.
