# Bir e-posta adresini yönetici tarafından doğrulanmış olarak işaretleme

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

Adresi kendi yetkinizle doğrulanmış olarak işaretler. Kullanıcıya kod veya bağlantı gönderilmez ve doğrulama yöntemi `admin_api` olarak saklanır; bu nedenle kullanıcının posta kutusunu kontrol ettiğinin kanıtı değildir. Adresi kendiniz doğrulamadıysanız `:send-verification` kullanmayı tercih edin. Adres zaten doğrulanmışsa hiçbir şey yazılmaz ve `200` döndürülür. Ortamdaki diğer hesaplarda aynı adresin doğrulanmamış kopyaları kaldırılır. Değişiklik, işlemi yapan olarak API anahtarı ile yönetim denetim günlüğüne `user.email_verified` olarak yazılır ve `user.updated` olayı yayımlanır.

## İstek

| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
| `user_id` | path | evet | Kullanıcı kimliği, `usr_` önekiyle. |
| `email_id` | path | evet | E-posta satırının kimliği (dahili UUID, küçük harf, tire ile ayrılmış), `GET /v1/users/{user_id}/emails` tarafından döndürüldüğü gibi. |

İstek gövde almaz (boş gövde veya `{}` kabul edilir).

## Yanıt

`200 OK`, güncellenmiş e-posta satırıyla birlikte. `users:read_pii` izni yoksa adres maskelenir (`a***@e***.com`).

```json
{
  "id": "0191f0a0-3333-7444-8555-666666666666",
  "email": "ada@example.com",
  "verified": true,
  "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 boş ya da `{}` değil. |
| 404 | `not_found` | Kullanıcı veya e-posta satırı bu ortamda yok, e-posta bu kullanıcıya ait değil veya bir kimlik hatalı biçimde. |
| 401 | `unauthenticated` | API anahtarı eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Anahtarda `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/0191f0a0-3333-7444-8555-666666666666:verify \
  -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](/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.