API

Обновить шаблон

Метаданные правятся на месте. Прикосновение к телу опубликованного шаблона порождает новый черновик.

PATCHapi.openemail.uk/templates/{id}

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

PATCH /templates/{id}

Метаданные правятся на месте. Прикосновение к телу опубликованного шаблона порождает новый черновик.

Пример

Требует templates:write. name, description и status — это метаданные; subject, document, html, slots, props и engine — это тело, и отправка любого из них порождает версию.

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  }'

Ответ

{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "publishedVersion": 3,  "latestVersion": 5,  "latest": { "object": "template_version", "version": 5, "state": "draft", "publishedAt": null }}

Новый черновик нельзя отправить, и ничто живое не сдвинулось: отправки продолжают разрешаться в версию 3, пока вы не опубликуете. В этом и весь смысл того, что правка не происходит на месте.

expectedVersion — это версия, которую вы прочитали перед правкой. Передайте её, и одновременная правка станет 409 version_conflict вместо молчаливой перезаписи; опустите — победит последняя запись, что нормально для одного человека в одной вкладке и неправильно для скрипта.

status: "archived" убирает шаблон из списка, не удаляя его. Архивный шаблон всё ещё разрешается при отправке, которая его называет. Архивирование — это уборка, а не аварийный выключатель.