E-posta şablonunu yayımla

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

Bir taslağı yeniden doğrular ve yayımlar. Önceki yayımlanmış sürüm arşivlenir ve yönetim denetim kaydı email_template.published aynı işlemde yazılır. Bundan sonra gönderilen e-postalar yeni sürümü kullanır.

Zaten yayımlanmış olan sürümü yayımlamak hiçbir şeyi değiştirmez ve onu yeniden döndürür; bu nedenle yeniden denemeler güvenlidir. Yayımlanmış sürümden eski bir taslak ya da arşivlenmiş bir sürüm 409 döndürür; arşivlenmiş bir sürüme dönmek için geri al işlemini kullanın.

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 Yayımlanacak taslak sürüm (1 veya daha büyük).

Yanıt

200 OK, yayımlanmış sürümle (status: published).

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 arşivlenmiş ya da yayımlanmış sürümden eski.
422 validation_failed version eksik ya da 1'den küçük, ya da taslak 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:publish \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"version":3}'

CLI: keenauth email-templates publish verify_email en --version 3