Kullanıcının tüm ikinci faktörlerini sıfırla
POST /v1/users/{user_id}/authenticators:reset · izin user-credentials:write
Kullanıcının tüm ikinci faktörlerini iptal eder ve kurtarma kodlarını siler; kullanıcı bir sonraki girişte yeniden bir faktör kaydeder. include_passkeys varsayılan olarak true'dur; false ile passkey'ler (both rolündekiler dahil) korunur. Adımlar en iyi çaba esasıyla çalışır ve tekrarlanabilir; bir bildirim hatası çağrıyı başarısız kılmaz (notified). Yanıt yalnızca sayıları içerir, kodları veya gizli bilgileri asla içermez. Yeniden denemelerin güvenli olması için bir Idempotency-Key başlığı gönderin.
İstek
| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
user_id |
path | evet | usr_ önekli kullanıcı kimliği. |
İsteğe bağlı gövde:
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
include_passkeys |
boolean | hayır | Varsayılan olarak true: passkey'ler de iptal edilir. false ile passkey'ler (both rolü dahil) korunur. |
locale |
string | hayır | Bildirimin BCP 47 dil etiketi, örneğin tr. Varsayılan olarak kullanıcının veya ortamın dili kullanılır. |
Yanıt
200 OK. Gövde, yapılanların sayısını içerir.
{
"revoked_authenticators": 3,
"recovery_codes_deleted": true,
"notified": true
}
Hatalar
Her hata, kararlı bir code değeri içeren bir application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 400 | malformed_request, unknown_field |
Gövde geçerli JSON değilse veya bilinmeyen bir alan içeriyorsa. |
| 415 | unsupported_media_type |
Content-Type: application/json olmadan bir gövde gönderildiyse. |
| 422 | validation_failed |
locale geçerli bir BCP 47 dil etiketi değilse veya bir alanın türü yanlışsa. |
| 404 | not_found |
Kullanıcı bu ortamda yoksa (veya kimlik bozuksa). |
| 401 | unauthenticated |
API anahtarı eksik, geçersiz veya iptal edilmişse. |
| 403 | insufficient_permissions |
Anahtarda user-credentials:write izni yoksa. |
| 429 | rate_limited |
Hız sınırı aşılmışsa; Retry-After değerine uyun. |
| 503 | service_unavailable |
Bir bağımlılık geçici olarak kullanılamıyorsa; daha sonra yeniden deneyin. |
Örnek
curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/authenticators:reset \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"include_passkeys": false, "locale": "en"}'
Kişisel veriler
Bu uç nokta kişisel veri içerir: kimlik bilgileri. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süre tutulduğu ve nasıl silindiği açıklanır. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.