Şablonlar

Tekrar kullanılan mail içerikleri sunucuda şablon olarak saklanabilir. Oluşturma/güncelleme gövdesinde name, subject, html üçü de zorunludur (eksik 422 validation_error). PUT tam güncellemedir ve her başarılı çağrıda version 1 artar.

Uçlar (7)

GET/templatesListe
POST/templatesOluştur
GET/templates/{id}Tekil
PUT/templates/{id}Tam güncelleme (Version +1)
DELETE/templates/{id}Sil
POST/templates/{id}/render-previewDeğişkenli önizleme
POST/templates/{id}/send-testTest gönderimi (kredi yok)

Liste

GET/public/v1/templatesscoperead

En yeni başta, sayfalı zarf (items/totalCount/page/pageSize).

Sorgu parametreleri

Ad	Tip	Zorunlu	Açıklama
`page`	integer	hayır	Sayfa numarası, ≥ 1.
`pageSize`	integer	hayır	1–100 (varsayılan 20).
`search`	string	hayır	Ad/konu içinde arar.

Hatalar

GET/templates

curl "https://api.mailmaks.com/mail/api/public/v1/templates?page=1&pageSize=20&search=randevu" \
  -H "Authorization: Bearer mm_live_..."

Yanıt200

{
  "items": [
    {
      "id": "tpl_…",
      "name": "Randevu Hatırlatma",
      "subject": "Randevu — {{tarih}}",
      "html": "<p>Sayın {{ad}}…</p>",
      "version": 3,
      "createdAt": "…",
      "updatedAt": "…"
    }
  ],
  "totalCount": 1,
  "page": 1,
  "pageSize": 20
}

Oluştur

POST/public/v1/templatesscopesend

Gövde

Ad	Tip	Zorunlu	Açıklama
`name`	string	evet	Şablon adı.
`subject`	string	evet	Konu; `{{degisken}}` desteklenir.
`html`	string	evet	HTML gövde.

Hatalar

POST/templates

curl -X POST https://api.mailmaks.com/mail/api/public/v1/templates \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Randevu Hatırlatma",
    "subject": "Randevu — {{tarih}}",
    "html": "<p>Sayın {{ad}}…</p>"
  }'

Yanıt200

{
  "id": "tpl_…",
  "name": "Randevu Hatırlatma",
  "subject": "Randevu — {{tarih}}",
  "html": "<p>Sayın {{ad}}…</p>",
  "version": 1,
  "createdAt": "…",
  "updatedAt": "…"
}

Tekil

GET/public/v1/templates/{id}scoperead

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Şablon id'si (`tpl_…`).

Hatalar

GET/templates/{id}

curl https://api.mailmaks.com/mail/api/public/v1/templates/tpl_… \
  -H "Authorization: Bearer mm_live_..."

Yanıt200

{
  "id": "tpl_…",
  "name": "Randevu Hatırlatma",
  "subject": "Randevu — {{tarih}}",
  "html": "<p>Sayın {{ad}}…</p>",
  "version": 3,
  "createdAt": "…",
  "updatedAt": "…"
}

Tam güncelleme (Version +1)

PUT/public/v1/templates/{id}scopesend

PUT tam güncellemedir; üç alan da gönderilir ve her başarılı çağrıda version 1 artar.

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Şablon id'si (`tpl_…`).

Gövde

Ad	Tip	Zorunlu	Açıklama
`name`	string	evet	Şablon adı.
`subject`	string	evet	Konu; `{{degisken}}` desteklenir.
`html`	string	evet	HTML gövde.

Hatalar

PUT/templates/{id}

curl -X PUT https://api.mailmaks.com/mail/api/public/v1/templates/tpl_… \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Randevu Hatırlatma",
    "subject": "Randevu — {{tarih}}",
    "html": "<p>Sayın {{ad}}, …</p>"
  }'

Yanıt200

{
  "id": "tpl_…",
  "name": "Randevu Hatırlatma",
  "subject": "Randevu — {{tarih}}",
  "html": "<p>Sayın {{ad}}…</p>",
  "version": 4,
  "createdAt": "…",
  "updatedAt": "…"
}

Sil

DELETE/public/v1/templates/{id}scopesend

Başarıda 204 (gövdesiz).

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Şablon id'si (`tpl_…`).

Hatalar

Değişkenli önizleme

POST/public/v1/templates/{id}/render-previewscoperead

{{degisken}} değerlerini şablonun güncel subject/html'ine uygular; durum değiştirmez (bu yüzden read scope'u — HTTP fiili POST olsa da).

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Şablon id'si (`tpl_…`).

Gövde

Ad	Tip	Zorunlu	Açıklama
`variables`	object	hayır	Boş/verilmemişse yer tutucular olduğu gibi görünür (render edilmemiş önizleme).

Hatalar

POST/templates/{id}/render-preview

curl -X POST https://api.mailmaks.com/mail/api/public/v1/templates/tpl_…/render-preview \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "variables": {
      "ad": "Ayşe",
      "tarih": "18 Eylül"
    }
  }'

Yanıt200

{
  "subject": "Randevu — 18 Eylül",
  "html": "<p>Sayın Ayşe…</p>"
}

Test gönderimi (kredi yok)

POST/public/v1/templates/{id}/send-testscopesend

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Şablon id'si (`tpl_…`).

Gövde

Ad	Tip	Zorunlu	Açıklama
`identityId`	string	evet	Gönderen kimlik id'si (id'ler kimlik CRUD yanıtlarından gelir; `messages/test`'in `from` adres çözümünden bilinçli farklı, panel paritesi).
`recipient`	string	evet	Test alıcısı.

Kredi düşmez; bastırma/MX kontrolü uygulanmaz. Şablon değişkensiz (yer tutucular görünür halde) gönderilir.
Şablon veya kimlik bulunamadıysa 404 not_found; kimlik doğrulanmamışsa 422 identity_not_verified; sağlayıcı hatasında 502 send_failed.

POST /messages şablon id'siyle gönderim almaz (v1'de templateId alanı yok); şablon içeriğini GET /templates/{id} veya render-preview ile alıp mesaj gövdesine koyarsınız.

Hatalar

POST/templates/{id}/send-test

curl -X POST https://api.mailmaks.com/mail/api/public/v1/templates/tpl_…/send-test \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "identityId": "idn_…",
    "recipient": "test@ornek.com"
  }'

Yanıt200

{
  "messageId": "…"
}