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

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

curl https://api.eu.keenauth.com/v1/email-templates \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth email-templates list