Přejít na dokumentaci
API

Úprava šablony

Metadata se upravují na místě. Sáhnutí na tělo publikované šablony vytvoří nový koncept.

PATCHapi.openemail.uk/templates/{id}

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

PATCH /templates/{id}

Metadata se upravují na místě. Sáhnutí na tělo publikované šablony vytvoří nový koncept.

Příklad

Vyžaduje templates:write. name, description a status jsou metadata; subject, document, html, slots, props a engine jsou tělo a odeslání kteréhokoli z nich vytvoří novou verzi.

curl
curl -X PATCH "$OE/templates/order-shipped" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "html": "<p>Hello {{customer}}, {{orderId}} is on its way.</p>",    "expectedVersion": 4  }'
Odpověď
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "publishedVersion": 3,  "latestVersion": 5,  "latest": { "object": "template_version", "version": 5, "state": "draft", "publishedAt": null }}

Nový koncept nelze odeslat a nic živého se nepohnulo: odeslání dál vyhodnocují verzi 3, dokud nepublikujete. To je celý důvod, proč se úprava neprovádí na místě.

expectedVersion je verze, kterou jste přečetli před úpravou. Dodejte ji a souběžná úprava bude 409 version_conflict místo tichého přepsání; vynechte ji a vyhraje poslední zápis, což je v pořádku pro jednoho člověka v jedné záložce a špatně pro skript.

status: "archived" vyřadí šablonu ze seznamu, aniž by ji smazal. Archivovaná šablona se pro odeslání, které ji jmenuje, stále vyhodnotí. Archivace je úklid, ne vypínač.