Template
Simpan HTML/subject, kirim dengan alias dan variabel {{nama}}.
Template per akun. Bukan blast, bukan React Email. Hanya ganti {{variabel}}.
Dashboard
Halaman Template: buat alias (unik per akun), nama, subject, HTML, text. Maks 50.
Uji kirim bisa memilih template + JSON variables — jalur yang sama dengan API.
Kirim lewat API
Pakai template + variables, atau html/text. Jangan keduanya.
subject opsional: kosong = subject dari template. Kalau diisi, itu yang dipakai (juga di-render {{var}}).
Attachment boleh bersama template.
curl -X POST https://api.mailnation.id/emails \
-H "Authorization: Bearer mn_live_…" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: otp-847291' \
-d '{
"from": "noreply@domain-anda.id",
"to": "user@gmail.com",
"template": "otp",
"variables": { "code": "847291" }
}'Variabel
| Aturan | Nilai |
|---|---|
| Sintaks | {{nama}} — huruf/angka/underscore |
| Jumlah | maks 32 |
| Nilai | string, angka, atau boolean. Maks 2048 karakter |
| HTML | nilai di-escape (< jadi <) |
| Subject/text | newline dihapus |
| Tidak ada | if, loop, nested object, eksekusi kode |
Variabel yang tidak dikirim jadi string kosong.
SMTP
Header opsional. Body DATA diganti hasil render (attachment di DATA diabaikan).
X-Mailnation-Template: otp
X-Mailnation-Template-Data: {"code":"847291"}JSON harus muat satu header (tanpa newline). Kalau template tidak ada: SMTP 550. Header tidak valid: 554.
Alias
2–63 karakter: huruf kecil di awal, lalu a-z, 0-9, atau -. Contoh: otp, invoice-paid.