Belgelere geç
API

Bir sürüm yayımla

Mevcut taslağı dondurur ve bir gönderimin çözümlediği şey yapar.

POSTapi.openemail.uk/templates/{id}/versions

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

POST /templates/{id}/versions

Mevcut taslağı dondurur ve bir gönderimin çözümlediği şey yapar.

Örnek

templates:write gerekir. Sürüm koleksiyonuna bir POST'tur, çünkü yarattığı şey odur. 201 döner.

curl
curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"
Yanıt
{  "object": "template_version",  "id": "tplv_5d31c2a8…",  "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",  "version": 5,  "state": "published",  "engine": "html",  "subject": "Order {{orderId}} is on its way",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "publishedAt": "2026-08-30T11:02:19.000Z",  "createdAt": "2026-08-30T10:58:04.000Z",  "template": { "object": "template", "publishedVersion": 5, "latestVersion": 5 }}

Gövde, gönderim anında değil burada derlenir. Render edilmeyen bir şablon, onu yayımlayan kişi için hata verir ki bu, düzeltebilecek birinin önünde hata verebileceği son andır.

Idempotent. Zaten yayımlanmış bir başı yayımlamak, birebir aynı bir sürüm üretmek yerine onu değiştirmeden döndürür; dolayısıyla bir dağıtım betiği bunu her çalıştığında çağırabilir.

Hiçbir şeyin bildirmediği bir anahtara başvuran bir gövde invalid_template, bir 422'dir ve hiçbir şey yayımlanmaz.