Ein Template aktualisieren
Metadaten werden an Ort und Stelle gepatcht. Wer den Body eines veröffentlichten Templates anfasst, erzeugt einen neuen Entwurf.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
PATCH /templates/{id}
Metadaten werden an Ort und Stelle gepatcht. Wer den Body eines veröffentlichten Templates anfasst, erzeugt einen neuen Entwurf.
Beispiel
Benötigt templates:write. name, description und status sind Metadaten; subject, document, html, slots, props und engine sind der Body, und eines davon zu senden ist es, was eine Version erzeugt.
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 }}Der neue Entwurf ist nicht versendbar, und im Laufenden hat sich nichts bewegt: Sendungen lösen weiterhin Version 3 auf, bis Sie veröffentlichen. Genau deshalb passiert die Bearbeitung nicht an Ort und Stelle.
expectedVersion ist die Version, die Sie vor dem Bearbeiten gelesen haben. Geben Sie sie mit, und eine gleichzeitige Bearbeitung ist ein 409 version_conflict statt eines stillen Überschreibens; lassen Sie sie weg, gewinnt der letzte Schreibzugriff, was für eine Person in einem Tab in Ordnung ist und für ein Skript falsch.
status: "archived" nimmt ein Template aus der Liste, ohne es zu löschen. Ein archiviertes Template löst für einen Versand, der es benennt, weiterhin auf. Archivieren ist Aufräumen, kein Notausschalter.