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

خواندن یک نسخه

یک بازنگری همراه با بدنه‌اش، تا بدون بازگرداندن ببینید نسخهٔ قدیمی چه دارد.

GETapi.openemail.uk/templates/{id}/versions/{version}

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

GET /templates/{id}/versions/{version}

یک بازنگری همراه با بدنه‌اش، تا بدون بازگرداندن ببینید نسخهٔ قدیمی چه دارد.

نمونه

نیازمند templates:read. فهرست نسخه‌ها بدنه‌ها را کنار می‌گذارد. بدنه‌ها اینجا هستند.

curl
curl "$OE/templates/order-shipped/versions/3" -H "$AUTH"
پاسخ
{  "object": "template_version",  "id": "tplv_5d31c2a8…",  "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",  "version": 3,  "state": "published",  "engine": "blocks",  "subject": "Order {{orderId}} is on its way",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "document": {    "preview": "Your order is on its way",    "tailwind": false,    "fonts": [],    "body": [{ "kind": "Heading", "text": "Order {{orderId}} is on its way" }],    "slots": [],    "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }]  },  "html": null,  "publishedAt": "2026-07-14T09:12:44.000Z",  "createdAt": "2026-07-14T09:10:02.000Z"}

خواندن یک نسخه چیزی را تغییر نمی‌دهد. بازگرداندن آن پیش‌نویس را جابه‌جا می‌کند، پس برای مقایسه، ممیزی، یا برداشتن یک بلوک از طرحی که مدت‌هاست عوض کرده‌اید، همین فراخوان درست است. برگرداندن آن همچنان کار POST /templates/{id}/versions/{version}/restore است.

تنها یکی از document و html محتوا دارد و engine می‌گوید کدام. html همان نشانه‌گذاری است دقیقاً آن‌گونه که فرستاده شد، پیش از پاک‌سازیِ هنگام انتشار؛ یعنی همان چیزی که در یک PATCH بازمی‌فرستید، نه آنچه گیرنده دریافت کرده است.

شماره‌ای که کسی منتشرش نکرده، یا شماره‌ای که حذف شده، خطای 404 template_version_not_found می‌دهد. شماره‌ها هرگز دوباره استفاده نمی‌شوند، پس شمارهٔ حذف‌شده همان‌طور رفته می‌ماند.