Kullanıcıya doğrulanmamış ikincil bir e-posta adresi ekleyin

POST /v1/users/{user_id}/emails · izin users:write

Kullanıcıya doğrulanmamış ikincil bir e-posta adresi ekler. Adres saklanmadan önce normalleştirilir. Kullanıcıda aynı adres zaten varsa yeni satır yazılmaz ve mevcut satır döndürülür (doğrulanmış veya birincil olabilir); bu nedenle isteği tekrarlamak güvenlidir. Yönetim denetim günlüğüne, aktör olarak API anahtarıyla birlikte user.email_added olarak yeni bir satır yazılır; adresin kendisi denetim kaydına yazılmaz. Adresi doğrulamak için POST /v1/users/{user_id}/emails/{email_id}:send-verification ile bir doğrulama e-postası gönderin veya :verify ile doğrulanmış olarak işaretleyin.

İstek

Parametre Konum Zorunlu Açıklama
user_id yol evet Kullanıcı kimliği, usr_ ön ekli.
Alan Tür Zorunlu Açıklama
email metin evet Adres, en fazla 320 karakter.

Yanıt

201 Created ile e-posta satırı. users:read_pii izni olmadan adres maskelenir (a***@e***.com).

{
  "id": "0191f0a0-3333-7444-8555-666666666666",
  "email": "ada@example.com",
  "verified": false,
  "primary": false,
  "created_at": "2026-01-15T09:30:00Z"
}

Hatalar

Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.

HTTP code Ne zaman
400 malformed_request, unknown_field Gövde geçerli bir JSON değil veya bilinmeyen bir alan içeriyor.
409 conflict Adres, bu ortamdaki başka bir kullanıcıda doğrulanmış (errors[]: /email, email_taken).
409 email_limit_reached Kullanıcının zaten 10 adresi var.
415 unsupported_media_type Gövde Content-Type: application/json olmadan gönderildi.
422 validation_failed email eksik, boş, 320 karakterden uzun, geçerli bir adres değil veya türü yanlış.
404 not_found Kullanıcı bu ortamda yok, siliniyor veya kimlik biçimi hatalı.
401 unauthenticated API anahtarı eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Anahtarın users:write izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After değerine uyun.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'

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.