Limitler
Limit tablosu
| Konu | Limit |
|---|---|
| Oran sınırı | Anahtar başına 120 istek/dk (hesaba özel kademe tanımlanabilir) — 429 + Retry-After |
| Günlük gönderim tavanı | Hesaba özel tanımlanabilir (TR günü) — 429 daily_cap + Retry-After |
| İşlemsel mesaj alıcısı | to ≤ 50; kredi = to+cc+bcc geçerli toplamı |
| Kampanya alıcısı | ≤ 10.000 |
| Ek (attachment) | Tekil dosya ≤ 20 MB; mesaj toplamı ≤ 20 MB; upload TTL 24 saat |
| Idempotency-Key | 1–128 görünür ASCII karakter; kayıt TTL 24 saat |
| Konu (subject) | 500 karaktere kırpılarak saklanır |
customerRef | ≤ 64 karakter, [A-Za-z0-9_-] |
| Bastırma ekleme | Tek istekte ≤ 1.000 adres |
| Events poll | limit ≤ 500 (varsayılan 100); olay saklama 30 gün |
| Webhook | Hesap başına 3 endpoint; teslim zaman aşımı 10 sn; 5 deneme (1 dk/5 dk/30 dk/2 sa/12 sa); ardışık 20 başarısızlıkta auto-disable |
| Sayfalama | campaigns ve templates listeleri pageSize ≤ 100; rapor, recipients ve suppressions pageSize ≤ 500 (recipients varsayılan 20); recipient history ≤ 500 satır; CSV export sınırsız (streaming) |
Yayın öncesi netleşecekler
Aşağıdakiler koddan teyitli sözleşmenin dışında kalan, deploy/karar bekleyen konulardır:
- Kesin public host: bu kılavuz
https://api.mailmaks.com/mail/apitabanını varsayar (mimar onaylı domain planı: api.mailmaks.com); DNS/TLS/LB kurulumu deploy fazında yapılacak ve taban URL o zaman kesinleşecek./mail/apiyol öneki servis route'larından gelir; LB'nin path'i sadeleştirip sadeleştirmeyeceği deployda netleşir. - API anahtarı edinme kanalı: anahtarlar portal üzerinden (Ayarlar → API Anahtarları) verilir; portal-canlı BE bağlantısı deploy ile açılacak. O güne kadar hesap ve anahtar açılışı MailMaks admin'i tarafından elle yapılır.
- Günlük gönderim tavanı ve müşteri-özel oran kademesi değerleri hesap açılışında ticari olarak belirlenir (API'de sabit varsayılan yoktur; tavan tanımsızsa denetim uygulanmaz).
- Olay replay ucu (webhook kesintisi sonrası geriye dönük yeniden gönderim) v1.1 planındadır; v1'de telafi kanalı
GET /eventspoll'üdür. - `mm_test_` test anahtarı yoktur (mimar kararı: tek ortam); sandbox davranışı ileride ayrıca değerlendirilebilir.
- `POST /messages`'ta `templateId` alanı yoktur — şablonlu işlemsel gönderim ayrı karar; v1'de şablon içeriği
render-previewile alınıp gövdeye konur. - Swagger/OpenAPI: servis
/swagger/public-v1/swagger.jsonaltında makine-okur tanım yayınlar; public URL'i deployda netleşecek. Bkz. OpenAPI.
MailMaks Public API v1 — bu kılavuz servis kodundaki davranışı birebir tarif eder (kaynak: `Controllers/PublicApi/`, 43 uç, 2026-09-15). Geriye uyumsuz değişiklik yapılmaz; eklemeler sürüm notuyla duyurulur.*