# E-posta şablonlarını listele

`GET /v1/email-templates` · izin `email-templates:read`

Özelleştirilebilir her e-posta ailesini plan sırasına göre, sürümü bulunan dillerle birlikte döndürür. Liste sabittir ve sayfalanmaz (`list_metadata` imleçleri her zaman `null`). Okuma her planda çalışır.

Her aile, bir şablonun neleri içermesi gerektiğini gösterir:

- `security`: platform, şablonun kaldıramayacağı bir güvenlik bloğu ekler.
- `requires`: iletinin hem HTML hem düz metin gövdesinde göstermesi gereken değer: `code`, `link`, `code_or_link` veya `none`.
- `available`: `false` ise ailenin bu sürümde henüz sistem şablonu yoktur, bu yüzden taslaklar reddedilir.
- `variables`: şablonun kullanabileceği Liquid değişkenleri.

## Yanıt

`200 OK`

```json
{
  "data": [
    {
      "family": "verify_email",
      "security": false,
      "requires": "code_or_link",
      "available": true,
      "variables": ["application.name", "code", "dir", "environment.display_name", "expires_in_minutes", "link", "locale", "support_url", "user.email"],
      "locales": [{"locale": "en", "latest_version": 3, "published_version": 2}]
    }
  ],
  "list_metadata": {"before": null, "after": null}
}
```

## Hatalar

| HTTP | code | Ne zaman |
|---|---|---|
| 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 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth email-templates list`