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

جلب قالب

يقبل المعرّف أو الـ slug. ويعود أحدث إصدار كاملاً، بما في ذلك المتن.

GETapi.openemail.uk/templates/{id}

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

GET /templates/{id}

يقبل المعرّف أو الـ slug. ويعود أحدث إصدار كاملاً، بما في ذلك المتن.

مثال

يتطلب templates:read. المعرّفات تحمل البادئة tpl_ ولا يمكن لقيم slug أن تحملها، فلا تتصادم المفردتان على هذا المسار.

curl
curl "$OE/templates/order-shipped" -H "$AUTH"
الاستجابة
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "name": "Order shipped",  "slug": "order-shipped",  "status": "active",  "publishedVersion": 3,  "latestVersion": 4,  "subject": "Order {{orderId}} is on its way",  "engine": "html",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "latest": {    "object": "template_version",    "id": "tplv_5d31c2a8…",    "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",    "version": 4,    "state": "draft",    "engine": "html",    "subject": "Order {{orderId}} is on its way",    "slots": [],    "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],    "document": null,    "html": "<p>Hello {{customer}}, {{orderId}} left the warehouse.</p>",    "createdAt": "2026-08-28T16:03:10.000Z",    "publishedAt": null  },  "createdAt": "2026-08-01T09:12:44.000Z",  "updatedAt": "2026-08-28T16:03:10.000Z"}

الحقل latest هو الإصدار الأحدث، وهو المسوّدة حين يوجد تعديل غير منشور. أما الحقول المجاورة له (subject وengine وslots وprops) فتصف الإصدار المنشور، لأنه ما يحلّه الإرسال.

الحقل document هو شجرة الكتل وقيمته null تحت engine: "html"؛ وhtml هو الترميز كما أُرسل وقيمته null تحت engine: "blocks". ولا يحمل أياً منهما إلا الجلب المفرد. فقائمة إصدارات يحمل كل منها شجرة كاملة حمولة لم يطلبها أحد.