# 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`).

```json
{
  "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

```bash
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](/docs/policies/personal-data) 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.