Actualitzar una plantilla
Les metadades es modifiquen al lloc. Tocar el cos d'una plantilla publicada encunya un esborrany nou.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
PATCH /templates/{id}
Les metadades es modifiquen al lloc. Tocar el cos d'una plantilla publicada encunya un esborrany nou.
Exemple
Necessita templates:write. name, description i status són metadades; subject, document, html, slots, props i engine són el cos, i enviar-ne qualsevol és el que encunya una versió.
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 }}El nou esborrany no es pot enviar i no s'ha mogut res en producció: els enviaments continuen resolent la versió 3 fins que publiquis. Aquest és tot el motiu pel qual l'edició no es fa al lloc.
expectedVersion és la versió que has llegit abans d'editar. Proporciona-la i una edició concurrent serà un 409 version_conflict en comptes d'una sobreescriptura silenciosa; omet-la i guanya l'última escriptura, cosa que va bé per a una persona en una pestanya i malament per a un script.
status: "archived" treu una plantilla de la llista sense esborrar-la. Una plantilla arxivada continua resolent-se per a un enviament que l'anomeni. Arxivar és endreçar, no pas un interruptor d'emergència.