E-posta adresini birincil yapın
POST /fapi/v1/me/emails/{email_id}:set-primary · çağrı ortamın Giriş yap ana sunucusundan yapılır
Kimliği doğrulanmış kullanıcının doğrulanmış e-posta adreslerinden birini birincil adres yapar. Doğrulanmamış bir adres birincil olamaz; önce doğrulayın. Değişiklikten sonra önceki birincil adrese ve kullanıcının diğer doğrulanmış adreslerine, hesap kurtarmayı açan "bu ben değildim" bağlantısı içeren bir güvenlik bildirimi gönderilir. Adres zaten birincilse yanıt yine 204 olur ve hiçbir şey değişmez veya gönderilmez. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döner. Farklı bir kökenteki birinci taraf uygulama bunun yerine ön uç API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön uç API erişim belirteci).
Oturumun son 5 dakika içinde doğrulanmış olması gerekir. Kullanıcının ikinci bir faktörü varsa, oturumun ayrıca ikinci bir faktörle (urn:idp:acr:mfa) açılmış olması gerekir.
İ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 sunucusu> olmalıdır. |
email_id: e-posta adresi tanımlayıcısı; yönetim API'sinin /v1/users/{user_id}/emails uç noktalarının kullandığı değerle aynıdır (küçük harfli UUID).
Gövde yok.
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ış veya ikinci faktör gerekiyor; WWW-Authenticate başlığındaki max_age=300 (ve uygunsa acr_values) ile yeniden doğrulayın. |
| 403 | origin_not_allowed |
Origin eksik veya hatalı. |
| 404 | not_found |
Bu kullanıcı için böyle bir e-posta adresi yok. |
| 409 | primary_requires_verified |
E-posta adresi doğrulanmamış. |
Örnek
curl -X POST https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc:set-primary \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
Kişisel veriler
Bu uç nokta kişisel veri içerir: son kullanıcı profili. 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.