# Bir e-posta adresine doğrulama e-postası gönder

`POST /v1/users/{user_id}/emails/{email_id}:send-verification` · izin `users:write`

Kullanıcının bir e-posta satırına doğrulama e-postası gönderir. `email_id`, dahili UUID'dir (küçük harf, tire ile ayrılmış). Yanıt, doğrulama isteğinin son kullanma süresini içerir; kod veya bağlantı döndürülmez. İsteğe bağlı gövde yalnızca e-postanın dilini seçer.

## İstek

| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
| `user_id` | path | evet | Kullanıcı kimliği, `usr_` önekli. |
| `email_id` | path | evet | E-posta satırının kimliği (dahili UUID, küçük harf, tire ile ayrılmış). |

İsteğe bağlı gövde:

| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| `locale` | string | hayır | E-postanın BCP 47 dil etiketi, örneğin `tr` veya `pt-BR`. Varsayılan olarak kullanıcının veya ortamın dilidir. |

## Yanıt

`200 OK`. `expires_at`, doğrulama isteğinin sona ereceği zamandır.

```json
{
  "expires_at": "2026-01-16T09: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ğildir veya bilinmeyen bir alan içerir. |
| 409 | `conflict` | E-posta zaten doğrulanmıştır. |
| 415 | `unsupported_media_type` | Gövde, `Content-Type: application/json` olmadan gönderilmiştir. |
| 422 | `validation_failed` | `locale` geçerli bir BCP 47 dil etiketi değildir veya bir alanın türü yanlıştır. |
| 404 | `not_found` | Kullanıcı veya e-posta satırı bu ortamda yoktur, e-posta bu kullanıcıya ait değildir ya da bir kimlik hatalı biçimlendirilmiştir. |
| 401 | `unauthenticated` | API anahtarı eksik, geçersiz veya iptal edilmiştir. |
| 403 | `insufficient_permissions` | Anahtarda `users:write` izni yoktur. |
| 429 | `rate_limited` | API hız sınırı veya kullanıcı başına e-posta gönderme sınırı aşıldı; `Retry-After` başlığına 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/0191f0a0-3333-7444-8555-666666666666:send-verification \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"locale": "en"}'
```

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