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