Bir kimlik doğrulayıcıyı yeniden adlandır
PATCH /fapi/v1/me/authenticators/{authenticator_id} · ortamın giriş ana makinesinden çağrılır
Kullanıcının bir kimlik doğrulayıcı kaydına verdiği görünen adı değiştirir. Kullanıcının __Host-idp_session çerezi gerekir; çerez eksik, süresi dolmuş veya iptal edilmişse 401 unauthenticated döner. Başka bir kökendeki birinci taraf bir uygulama bunun yerine Front API erişim belirtecini gönderebilir (DPoP kanıtıyla Authorization: DPoP <token>; bkz. Front 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://<giriş ana makinesi> olmalıdır. |
Gövde:
{"label": "Work laptop"}
label zorunludur; denetim karakterleri veya yön işaretçileri içeremez.
Yanıt
204 No Content.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 422 | validation_failed |
label eksik. |
| 422 | invalid_display_string |
label görünen ad kurallarına uymuyor. |
| 401 | unauthenticated |
Geçerli oturum çerezi yok. |
| 403 | origin_not_allowed |
Origin eksik veya yanlış. |
| 404 | not_found |
Bu kullanıcı için böyle bir kimlik doğrulayıcı yok. |
Örnek
curl -X PATCH https://example.keenauth.app/fapi/v1/me/authenticators/cred_01j9zzzzzzzzzzzzzzzzzzzzzz \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{"label": "Work laptop"}' \
-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.