قالب‌های میزبانی‌شده

چرخه عمر

هر قالب یک شناسه و کلید پایدار، یک پیش‌نویس قابل‌ویرایش، صفر یا چند نسخه منتشرشده تغییرناپذیر و چرخه عمری فعال یا بایگانی‌شده دارد. بایگانی کردن از ارسال‌های جدید مبتنی بر کلید جلوگیری می‌کند، بدون آنکه نسخه‌های قبلی یا سابقه استفاده حذف شوند.

متغیرها

متغیرها را با کلید، نوع، الزامی بودن و مقدار پیش‌فرض اختیاری تعریف کنید. اگر داده ارائه‌شده با قرارداد منتشرشده مطابقت نداشته باشد، رندر با 422 شکست می‌خورد. مقادیر درج‌شده بسته به زمینه escape می‌شوند.

ذخیره خودکار خوش‌بینانه

هر پیش‌نویس یک revision دارد. revision فعلی را به PUT /templates/:id/draft بفرستید. اگر ویرایشگر دیگری زودتر ذخیره کرده باشد، SendHQ کد 409 برمی‌گرداند؛ پیش از بازنویسی، دوباره بارگذاری کنید.

پیش‌نمایش، آزمایش، انتشار

1. با داده نمونه نماینده رندر کنید.
2. همه خطاهای یافت‌شده را برطرف کنید.
3. یک snapshot آزمایشی به نشانی‌ای که در اختیار دارید بفرستید.
4. همان پیش‌نویس را به‌عنوان یک نسخه تغییرناپذیر منتشر کنید.

ارسال با کلید

{
  "from": "hello@example.com",
  "to": [
    "customer@example.net"
  ],
  "template": {
    "key": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

ارسال قالب شخصی‌سازی‌شده دقیقاً به یک گیرنده To و بدون Cc یا Bcc نیاز دارد. برای گیرندگان با محتوای فردی از endpoint دسته‌ای استفاده کنید.

منشأ

هر ارسال مبتنی بر قالب، قالب، نسخه منتشرشده، نسخه کامپایلر و hash محتوای رندرشده را ثبت می‌کند تا بتوان هر پیام قدیمی را تا محتوایی که آن را تولید کرده ردیابی کرد.