Birincil e-postaya doğrulama e-postası gönderin

POST /v1/users/{user_id}:send-verification-email · İzin user-credentials:write

Kullanıcının birincil e-posta adresine doğrulama e-postası gönderir. Yanıt, doğrulama isteğinin sona erme zamanını içerir; kod veya bağlantı döndürülmez. Belirli bir e-posta kaydını hedeflemek için Bir e-posta adresine doğrulama e-postası gönderin bölümünü kullanın. İsteğe bağlı gövde yalnızca e-posta dilini seçer.

İstek

Parametre Konum Zorunlu Açıklama
user_id path evet Kullanıcı kimliği, usr_ önekiyle.

İ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 dili kullanılır.

Yanıt

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

{
  "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 JSON değil veya bilinmeyen bir alan içeriyor.
409 conflict Birincil e-posta adresi zaten doğrulanmış veya kullanıcının birincil e-posta adresi yok.
415 unsupported_media_type Gövde, Content-Type: application/json olmadan gönderildi.
422 validation_failed locale geçerli bir BCP 47 dil etiketi değil veya bir alanın türü yanlış.
404 not_found Kullanıcı bu ortamda yok (veya kimlik hatalı biçimde).
401 unauthenticated API anahtarı eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Anahtarda user-credentials:write izni yok.
429 rate_limited API hız sınırı veya kullanıcı başına e-posta gönderim 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:send-verification-email \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"locale": "en"}'