Kalo te dokumentacioni
API

Listo shabllonet

Çdo shabllon në lidhje, më të rinjtë të parët, me faqëzim keyset.

GETapi.openemail.uk/templates

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

GET /templates

Çdo shabllon në lidhje, më të rinjtë të parët, me faqëzim keyset.

Dy motorë

shell
export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"

Një shabllon është një trup i ruajtur një herë dhe i dërguar shumë herë, dhe i përket LIDHJES e jo atij që e shkroi. Një çelës i hapësirës së punës sheh të njëjtat shabllone që sheh një koleg, dhe fshirja e llogarisë së autorit nuk i merr me vete.

engine: "blocks" ruan një pemë, llojet e nyjeve të së cilës janë eksportet e @react-email/components (Section, Row, Column, Container, Text, Heading, Button, Link, Img, Hr, Markdown, CodeBlock dhe CodeInline) dhe props-et e së cilës janë ato të vetë këtyre komponentëve. Ajo validohet në hyrje, ndaj një nyjë e gabuar është një 422 në thirrjen që e shkroi e jo një email i prishur më vonë.

engine: "html" ruan markup-in që keni tashmë, të sanitizuar një herë kur publikohet versioni. Ky është opsioni te i cili duhet kapur kur shabllonet tuaja janë komponentë react-email që jetojnë në depon tuaj: renderoni komponentin me @react-email/render në build-in tuaj dhe postoni rezultatin. Nuk ka endpoint JSX dhe nuk do të ketë. API-ja pranon HTML sepse HTML është ajo që lexon një klient poste, dhe ekzekutimi i një komponenti të thirrësit do të blinte një sandbox që s'i duhet askujt.

Deklaruar siMbushur ngaKur mungon në dërgim
`slots`kushdo që redakton shablloninshfaqet default i vetë slot-it
`props`kushdo që dërgonmissing_template_prop, një 422, dhe asnjë postë nuk niset

Të dyja shkruhen si {{key}} në trup dhe në subjekt, dhe të dyja mbajnë një kind (text, url ose image) që vendos se si i bëhet escape vlerës kur zëvendësohet. Një çelës që nuk e deklaron asgjë dështon në publikim; një vlerë url skema e së cilës nuk është http, https ose mailto refuzohet në vend që të renderohet.

Një version i publikuar është i ngrirë. Redaktimi i trupit të një shablloni të publikuar krijon një draft të ri në vend që të ndryshojë atë që zgjidhin dërgimet e drejtpërdrejta, ndaj një koleg që rishkruan tekstin nuk mund të ndryshojë atë që dërgon tashmë kodi juaj, dhe fiksimi i version do të thotë se nuk mund ta ndryshojë as kur ai publikon.

Shembull

Kërkon templates:read. limit shkon deri në 100, status e ngushton te draft, active ose archived, dhe cursor është opak, ndaj kthejeni nextCursor që ju është dhënë në vend që të ndërtoni një të tillë.

curl
curl "$OE/templates?limit=25&status=active" -H "$AUTH"
Përgjigje
{  "object": "list",  "data": [    {      "object": "template",      "id": "tpl_9c1f0a4b7e05d3862c1f0a44",      "name": "Order shipped",      "slug": "order-shipped",      "description": null,      "status": "active",      "publishedVersion": 3,      "latestVersion": 4,      "createdAt": "2026-08-01T09:12:44.000Z",      "updatedAt": "2026-08-28T16:03:10.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

publishedVersion është ai që zgjidh një dërgim pa version, kurse latestVersion është drafti që rri sipër tij. Ndryshimi mes të dyve do të thotë se dikush ka redaktuar dhe nuk ka publikuar. Nuk është gabim, dhe ia vlen të shfaqet në një regjistër vendosjeje.

Një rresht është metadata. slots dhe props e deklaruara kthehen nga një marrje e vetme, që është thirrja për t'u bërë kur ju duhet të dini se çfarë t'i kaloni.