Przejdź do dokumentacji
API

Zaktualizuj szablon

Metadane są patchowane w miejscu. Ruszenie treści opublikowanego szablonu tworzy nową wersję roboczą.

PATCHapi.openemail.uk/templates/{id}

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

PATCH /templates/{id}

Metadane są patchowane w miejscu. Ruszenie treści opublikowanego szablonu tworzy nową wersję roboczą.

Przykład

Wymaga templates:write. name, description i status to metadane; subject, document, html, slots, props i engine to treść, a wysłanie któregokolwiek z nich jest tym, co tworzy nową wersję.

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  }'
Odpowiedź
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "publishedVersion": 3,  "latestVersion": 5,  "latest": { "object": "template_version", "version": 5, "state": "draft", "publishedAt": null }}

Nowa wersja robocza nie nadaje się do wysyłki i nic żywego się nie ruszyło: wysyłki nadal rozstrzygają wersję 3, dopóki nie opublikujesz. To cały powód, dla którego edycja nie dzieje się w miejscu.

expectedVersion to wersja, którą odczytałeś przed edycją. Podaj ją, a równoległa edycja to 409 version_conflict zamiast cichego nadpisania; pomiń ją, a wygrywa ostatni zapis, co jest w porządku dla jednej osoby w jednej karcie i złe dla skryptu.

status: "archived" wyjmuje szablon z listy, nie usuwając go. Zarchiwizowany szablon nadal rozstrzyga się dla wysyłki, która go wskaże. Archiwizacja to porządki, a nie wyłącznik awaryjny.