API

Verzió közzététele

Befagyasztja az aktuális piszkozatot, és azt teszi azzá, amit egy küldés felold.

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

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

POST /templates/{id}/versions

Befagyasztja az aktuális piszkozatot, és azt teszi azzá, amit egy küldés felold.

Példa

templates:write szükséges hozzá. POST a verziógyűjteményre, mert ezt hozza létre. 201 Created a válasz.

curl

curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"

Válasz

{  "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 }}

A törzs itt fordul le, nem küldéskor. Az a sablon, amely nem renderelhető, annak bukik el, aki közzéteszi, és ez az utolsó pillanat, amikor olyasvalaki előtt bukhat el, aki meg tudja javítani.

Idempotens. Egy már közzétett fej közzététele változatlanul adja vissza azt, nem pedig egy azonos verziót ver, tehát egy deploy szkript minden futáskor meghívhatja.

Az a törzs, amely olyan kulcsra hivatkozik, amelyet semmi nem deklarál, invalid_template, azaz 422, és semmi nem kerül közzétételre.