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

ساخت یک قالب

پیش‌نویس است مگر آنکه انتشارش را بخواهید. پیش‌نویس را می‌شود پیش‌نمایش گرفت و نمی‌شود فرستاد.

POSTapi.openemail.uk/templates

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

POST /templates

پیش‌نویس است مگر آنکه انتشارش را بخواهید. پیش‌نویس را می‌شود پیش‌نمایش گرفت و نمی‌شود فرستاد.

نمونه

به templates:write نیاز دارد. 201 برمی‌گرداند. اگر slug را ندهید از روی نام ساخته می‌شود، و همین است که باید در کد به آن تکیه کرد، چون نام چیزی است که آدم‌ها عوضش می‌کنند.

curl
curl -X POST "$OE/templates" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "name": "Order shipped",    "engine": "html",    "subject": "Order {{orderId}} is on its way",    "html": "<p>Hello {{customer}}, {{orderId}} left the warehouse.</p>",    "props": [      { "key": "orderId", "kind": "text", "required": true },      { "key": "customer", "kind": "text", "default": "there" }    ],    "publish": true  }'
پاسخ
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "name": "Order shipped",  "slug": "order-shipped",  "description": null,  "status": "active",  "publishedVersion": 1,  "latestVersion": 1,  "subject": "Order {{orderId}} is on its way",  "engine": "html",  "slots": [],  "props": [    { "key": "orderId", "kind": "text", "required": true, "default": null },    { "key": "customer", "kind": "text", "required": false, "default": "there" }  ],  "createdAt": "2026-08-30T10:41:02.000Z",  "updatedAt": "2026-08-30T10:41:02.000Z"}

از یک اسکریپت استقرار publish: true بگذارید. بدون آن نسخهٔ 1 را به‌صورت پیش‌نویس می‌گیرید، که وقتی قرار است آدمی اول متن را بخواند درست است و در هر چیز خودکاری نادرست.

نام تکراری template_name_taken است و slug تکراری template_slug_taken، هر دو 409 روی همان اتصال و نه روی کل حساب.

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