تخطَّ إلى المستندات
API

نشر إصدار

يجمّد المسوّدة الحالية ويجعلها ما يحلّه الإرسال.

POSTapi.openemail.uk/templates/{id}/versions

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

POST /templates/{id}/versions

يجمّد المسوّدة الحالية ويجعلها ما يحلّه الإرسال.

مثال

يتطلب templates:write. وهو POST إلى مجموعة الإصدارات، لأن ذلك ما ينشئه. ويعيد 201.

curl
curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"
الاستجابة
{  "object": "template_version",  "id": "tplv_5d31c2a8…",  "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",  "version": 5,  "state": "published",  "engine": "html",  "subject": "Order {{orderId}} is on its way",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "publishedAt": "2026-08-30T11:02:19.000Z",  "createdAt": "2026-08-30T10:58:04.000Z",  "template": { "object": "template", "publishedVersion": 5, "latestVersion": 5 }}

يُترجَم المتن هنا لا عند الإرسال. فالقالب الذي لا يُعرض يفشل أمام من ينشره، وهي آخر لحظة يمكن أن يفشل فيها أمام شخص قادر على إصلاحه.

متكافئ الاستدعاء. فنشر رأس منشور أصلاً يعيده كما هو بدل أن يسكّ إصداراً مطابقاً، ومن ثمّ يجوز لسكربت النشر أن يستدعيه في كل تشغيل.

المتن الذي يشير إلى مفتاح لا يعلنه شيء هو invalid_template، وهو 422، ولا يُنشر شيء.