Saltar para a documentação
API

Obter um modelo

Aceita o id ou o slug. A versão mais recente é devolvida completa, incluindo o corpo.

GETapi.openemail.uk/templates/{id}

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

GET /templates/{id}

Aceita o id ou o slug. A versão mais recente é devolvida completa, incluindo o corpo.

Exemplo

Requer templates:read. Os ids têm o prefixo tpl_ e os slugs não o podem ter, pelo que os dois vocabulários não podem colidir neste caminho.

curl
curl "$OE/templates/order-shipped" -H "$AUTH"
Resposta
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "name": "Order shipped",  "slug": "order-shipped",  "status": "active",  "publishedVersion": 3,  "latestVersion": 4,  "subject": "Order {{orderId}} is on its way",  "engine": "html",  "slots": [],  "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],  "latest": {    "object": "template_version",    "id": "tplv_5d31c2a8…",    "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44",    "version": 4,    "state": "draft",    "engine": "html",    "subject": "Order {{orderId}} is on its way",    "slots": [],    "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }],    "document": null,    "html": "<p>Hello {{customer}}, {{orderId}} left the warehouse.</p>",    "createdAt": "2026-08-28T16:03:10.000Z",    "publishedAt": null  },  "createdAt": "2026-08-01T09:12:44.000Z",  "updatedAt": "2026-08-28T16:03:10.000Z"}

latest é a versão MAIS RECENTE, que é o rascunho quando há uma edição por publicar. Os campos ao lado (subject, engine, slots, props) descrevem a versão PUBLICADA, porque é essa que um envio resolve.

document é a árvore de blocos e é null com engine: "html"; html é o markup tal como foi submetido e é null com engine: "blocks". Só a obtenção individual inclui qualquer um deles. Uma lista de versões em que cada uma contém uma árvore completa é um payload que ninguém pediu.