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