E-posta adresini kaldırın
DELETE /fapi/v1/me/emails/{email_id} · çağrı ortamın Giriş yap ana sunucusundan yapılır
Kimliği doğrulanmış kullanıcının e-posta adreslerinden birini kaldırır. Birincil adres kaldırılamaz; önce başka bir doğrulanmış adresi birincil yapın. Ortam bir e-posta adresi gerektiriyorsa, kullanıcının son doğrulanmış adresi de kaldırılamaz. 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: GET /fapi/v1/me/emails tarafından döndürülen e-posta adresi tanımlayıcısı (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_identifier_required |
Adres birincil adres. |
| 409 | last_verified_channel |
Adres kullanıcının son doğrulanmış adresi ve ortam bir e-posta adresi gerektiriyor. |
Örnek
curl -X DELETE https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc \
-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.