# 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](put.md) 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](list.md) 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

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

```bash
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`