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).
İ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:
{}
Yanıt
200 OK:
{"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
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 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.