E-posta şablonunu geri al

POST /v1/email-templates/{family}/{locale}:rollback · izin email-templates:write · Startup planı ve üstü

Daha önce yayımlanmış (şimdi arşivlenmiş) bir sürümün içeriğini yeniden doğrular ve source_version olarak geri dönülen sürüm numarasını ayarlayarak yeni bir sürüm olarak yayımlar. Geçmiş yeniden yazılmaz. email_template.rolled_back denetim kaydı aynı işlemde yazılır.

Hiç yayımlanmamış bir sürüm ya da şu anda yayımlanmış olan sürüm 409 döndürür.

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.

İstek

Alan Tür Zorunlu Açıklama
version integer evet Yeniden yayımlanacak arşivlenmiş sürüm (1 veya daha büyük).

Yanıt

200 OK, yeni yayımlanmış sürümle.

{
  "family": "verify_email",
  "locale": "en",
  "version": 4,
  "status": "published",
  "subject": "Confirm your email for {{ application.name }}",
  "html": "<p><a href=\"{{ link }}\">Confirm your email</a></p>",
  "text_body": "Confirm your email: {{ link }}",
  "from_name": null,
  "source_version": 1,
  "created_at": "2026-10-19T10:00:00Z",
  "published_at": "2026-10-19T10:00:00Z",
  "latest_version": 4,
  "published_version": 4
}

Hatalar

HTTP code Ne zaman
400 unknown_field Gövdede bilinmeyen bir alan var ya da gövde bir JSON nesnesi değil.
404 not_found Aile ya da dil bilinmiyor veya sürüm mevcut değil.
403 plan_feature_unavailable Ortamın planı özel e-posta şablonlarını içermiyor (Startup ve üstü; hangisinin gerektiği required_plan alanında yazar).
409 conflict Sürüm hiç yayımlanmamış ya da şu an yayımlanmış olan sürüm.
422 validation_failed version eksik ya da 1'den küçük, ya da içerik artık doğrulamayı geçmiyor.
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 -X POST https://api.eu.keenauth.com/v1/email-templates/verify_email/en:rollback \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"version":1}'

CLI: keenauth email-templates rollback verify_email en --version 1 --yes