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

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

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