E-posta şablonunu al
GET /v1/email-templates/{family}/{locale} · izin email-templates:read
Bir şablon yuvasının (bir aile ve bir dil) tek bir sürümünü döndürür: varsayılan olarak en yeni sürümü, ?version=published ile yayımlanmış olanı ya da ?version=N ile verilen numaralı sürümü. ETag başlığı yuvanın en yeni sürümüdür; taslak kaydederken bunu If-Match olarak gönderin.
Yol parametreleri
| Parametre | Açıklama |
|---|---|
family |
E-posta ailesi, örneğin verify_email veya email_otp (E-posta şablonlarını listele bölümüne bakın). |
locale |
Dil etiketi, örneğin en veya de. |
Sorgu parametreleri
| Parametre | Açıklama |
|---|---|
version |
published ya da bir sürüm numarası (1 veya daha büyük). En yeni sürüm için atlayın. |
Yanıt
200 OK, ETag: "3" ile
{
"family": "verify_email",
"locale": "en",
"version": 3,
"status": "draft",
"subject": "Confirm your email for {{ application.name }}",
"html": "<p>Hi,</p><p><a href=\"{{ link }}\">Confirm your email</a></p>",
"text_body": "Confirm your email: {{ link }}",
"from_name": null,
"source_version": null,
"created_at": "2026-10-19T09:00:00Z",
"published_at": null,
"latest_version": 3,
"published_version": 2
}
Hatalar
| HTTP | code | Ne zaman |
|---|---|---|
| 404 | not_found |
Aile ya da dil bilinmiyor, yuvada sürüm yok, published istendi ama yayımlanmış bir şey yok ya da sürüm mevcut değil. |
| 422 | validation_failed |
version ne published ne de pozitif bir sayı. |
| 401 | unauthenticated |
Kimlik bilgisi eksik, geçersiz ya da iptal edilmiş. |
| 403 | insufficient_permissions |
Kimlik bilgisinin gerekli izni yok. |
| 429 | rate_limited |
Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin. |
| 503 | service_unavailable |
Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin. |
Örnek
curl "https://api.eu.keenauth.com/v1/email-templates/verify_email/en?version=published" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth email-templates get verify_email en --version published