Kullanıcının birincil olmayan e-posta adresini sil
DELETE /v1/users/{user_id}/emails/{email_id} · izin users:write
Kullanıcının birincil olmayan bir e-posta adresini siler. Birincil adres silinemez; önce başka bir doğrulanmış adresi birincil yapmanız gerekir. Ortam e-posta adresi gerektirdiği sürece kullanıcının son doğrulanmış adresi silinemez. Her silme işlemi, API anahtarı aktör olarak kaydedilerek yönetim denetim günlüğüne user.email_removed olarak yazılır. Aynı satır tekrar silinmek istendiğinde satır artık var olmadığı için 404 döner: işlemin etkisi idempotenttir, ancak durum kodu aynı değildir.
İstek
| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
user_id |
path | evet | usr_ önekli kullanıcı kimliği. |
email_id |
path | evet | E-posta satırının kimliği (küçük harfli, tire içeren dahili UUID); GET /v1/users/{user_id}/emails yanıtında döner. |
İstek gövde içermez.
Yanıt
204 No Content.
Hatalar
Her hata, kararlı bir code değeri içeren bir application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 409 | primary_identifier_required |
Adres birincil adres ise. |
| 409 | last_verified_channel |
Ortam e-posta adresi gerektiriyorsa ve bu, son doğrulanmış adres ise. |
| 404 | not_found |
Kullanıcı veya e-posta satırı bu ortamda yoksa, e-posta bu kullanıcıya ait değilse ya da bir kimlik hatalıysa. |
| 401 | unauthenticated |
API anahtarı eksik, geçersiz veya iptal edilmişse. |
| 403 | insufficient_permissions |
Anahtarda users:write izni yoksa. |
| 429 | rate_limited |
Hız sınırı aşıldıysa; 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 DELETE https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails/0191f0a0-3333-7444-8555-666666666666 \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
Kişisel veriler
Bu uç nokta kişisel veri içerir: son kullanıcı profili. KeenAuth API'lerinde kişisel veriler bölümünde neyin saklandığı, ne kadar süreyle 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.