Bỏ qua tới phần tài liệu
API

Xuất bản một phiên bản

Đóng băng bản nháp hiện tại và biến nó thành thứ một lần gửi phân giải ra.

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

Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.

POST /templates/{id}/versions

Đóng băng bản nháp hiện tại và biến nó thành thứ một lần gửi phân giải ra.

Ví dụ

Cần templates:write. Là POST tới collection phiên bản, vì đó là thứ nó tạo ra. Trả về 201.

curl
curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"
Phản hồi
{  "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 }}

Phần thân được biên dịch ở đây chứ không phải lúc gửi. Một template không render được sẽ hỏng ngay trước mặt người xuất bản nó, và đó là thời điểm cuối cùng nó còn có thể hỏng trước mặt một người có thể sửa.

Idempotent. Xuất bản một phiên bản đầu đã được xuất bản sẽ trả về chính nó không đổi thay vì tạo ra một phiên bản y hệt, nên script triển khai có thể gọi lệnh này mỗi lần chạy.

Một phần thân tham chiếu tới một key không được khai báo ở đâu là invalid_template, một 422, và không có gì được xuất bản.