پرش به مستندات
API

به‌روزرسانی یک قالب

فراداده در جای خود وصله می‌شود. دست‌زدن به بدنهٔ یک قالب منتشرشده، پیش‌نویس تازه‌ای می‌سازد.

PATCHapi.openemail.uk/templates/{id}

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

PATCH /templates/{id}

فراداده در جای خود وصله می‌شود. دست‌زدن به بدنهٔ یک قالب منتشرشده، پیش‌نویس تازه‌ای می‌سازد.

نمونه

نیازمند templates:write. name، description و status فراداده‌اند؛ subject، document، html، slots، props و engine بدنه‌اند، و فرستادن هرکدام از آن‌هاست که نسخهٔ تازه می‌سازد.

curl
curl -X PATCH "$OE/templates/order-shipped" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "html": "<p>Hello {{customer}}, {{orderId}} is on its way.</p>",    "expectedVersion": 4  }'
پاسخ
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "publishedVersion": 3,  "latestVersion": 5,  "latest": { "object": "template_version", "version": 5, "state": "draft", "publishedAt": null }}

پیش‌نویس تازه قابل ارسال نیست و هیچ چیز زنده‌ای جابه‌جا نشده است: تا وقتی منتشر نکنید، ارسال‌ها همچنان به نسخهٔ 3 می‌رسند. کل دلیل اینکه ویرایش در جای خود انجام نمی‌شود همین است.

expectedVersion همان نسخه‌ای است که پیش از ویرایش خوانده‌اید. اگر آن را بدهید، ویرایش هم‌زمان به‌جای بازنویسی خاموش، 409 version_conflict می‌شود؛ اگر ندهید، آخرین نوشته برنده است، که برای یک نفر در یک تب خوب است و برای یک اسکریپت نادرست.

status: "archived" قالب را بدون حذف از فهرست بیرون می‌برد. قالب بایگانی‌شده همچنان برای ارسالی که نامش را ببرد پیدا می‌شود. بایگانی یک مرتب‌سازی است، نه کلید خاموشی.