فهرست قالب‌ها

همهٔ قالب‌های روی اتصال، تازه‌ترین اول، با صفحه‌بندی keyset.

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

قالب، بدنه‌ای است که یک بار ذخیره می‌شود و بارها فرستاده می‌شود، و به CONNECTION تعلق دارد نه به کسی که آن را نوشته است. یک کلید فضای کاری همان قالب‌هایی را می‌بیند که همکارش می‌بیند، و حذف حساب نویسنده آن‌ها را با خود نمی‌برد.

engine: "blocks" درختی را ذخیره می‌کند که نوع گره‌هایش همان خروجی‌های @react-email/components است (Section، Row، Column، Container، Text، Heading، Button، Link، Img، Hr، Markdown، CodeBlock و CodeInline) و props آن هم props خود همان کامپوننت‌هاست. هنگام ورود اعتبارسنجی می‌شود، پس یک گره نادرست به‌جای ایمیلی خراب در آینده، همان فراخوانی‌ای را که آن را نوشته با 422 روبه‌رو می‌کند.

engine: "html" همان نشانه‌گذاری‌ای را که از پیش دارید ذخیره می‌کند و هنگام انتشار نسخه یک بار پاک‌سازی می‌شود. وقتی قالب‌های شما کامپوننت‌های react-email در مخزن خودتان هستند، همین را انتخاب کنید: کامپوننت را در build خودتان با @react-email/render رندر کنید و نتیجه را بفرستید. هیچ نقطهٔ پایانی‌ای برای JSX وجود ندارد و قرار هم نیست وجود داشته باشد. API، HTML می‌گیرد چون آنچه یک کلاینت ایمیل می‌خواند HTML است، و اجرای کامپوننت فراخوان فقط یک sandbox را به ما تحمیل می‌کرد که کسی به آن نیازی ندارد.

هر دو در بدنه و در موضوع به شکل {{key}} نوشته می‌شوند و هر دو یک kind دارند (text، url یا image) که تعیین می‌کند مقدار هنگام جایگزینی چگونه escape شود. کلیدی که هیچ‌جا اعلام نشده باشد هنگام انتشار شکست می‌خورد؛ مقدار url ای که scheme آن http، https یا mailto نباشد، به‌جای رندر شدن رد می‌شود.

نیازمند templates:read. limit تا 100 می‌رود، status نتیجه را به draft، active یا archived محدود می‌کند، و cursor مبهم است، پس همان nextCursor ای را که گرفته‌اید بازگردانید و خودتان یکی نسازید.

curl "$OE/templates?limit=25&status=active" -H "$AUTH"

{  "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}