Bastırma listesi

Bounce, şikayet, abonelikten çıkma veya manuel eklemeyle oluşan adresler bastırma listesinde tutulur. scope hangi gönderim yolunun süzüleceğini belirler.

Uçlar (3)

GET/suppressionsListe
POST/suppressionsToplu manuel ekleme
DELETE/suppressions/{id}Kayıt sil

Liste

GET/public/v1/suppressionsscoperead

Sorgu parametreleri

Ad	Tip	Zorunlu	Açıklama
`page`	integer	hayır	Sayfa numarası, ≥ 1.
`pageSize`	integer	hayır	1–500 (varsayılan 50).
`customerRef`	string	hayır	Kendi müşteri kırılımınızı ayıklamak için filtre.

source: manual | hard_bounce | soft_bounce_threshold | complaint | unsubscribe
scope: campaign (yalnız kampanyaları süzer) | campaign_and_transactional (işlemsel maili de süzer)
customerRef yalnız korelasyon kurulabildiğinde dolar; boşsa yazılmaz.

Hatalar

GET/suppressions

curl "https://api.mailmaks.com/mail/api/public/v1/suppressions?page=1&pageSize=50&customerRef=hastane-42" \
  -H "Authorization: Bearer mm_live_..."

Yanıt200

{
  "items": [
    {
      "id": "sup_…",
      "email": "a@x.com",
      "source": "hard_bounce",
      "scope": "campaign_and_transactional",
      "customerRef": "hastane-42",
      "createdAt": "…"
    }
  ],
  "totalCount": 3,
  "page": 1,
  "pageSize": 50
}

Toplu manuel ekleme

POST/public/v1/suppressionsscopesend

Gövde

Ad	Tip	Zorunlu	Açıklama
`emails`	string[]	evet	Tek istekte en çok 1.000 adres (aşımı 422 `too_many_emails`). Bozuk sentaksli adres varsa istek toptan 422 ile reddedilir (kısmi ekleme yok).
`scope`	string	hayır	`campaign` \| `campaign_and_transactional`; boşsa `campaign`.
`customerRef`	string	hayır	Yeni açılan kayıtlara yazılır (max 64, `[A-Za-z0-9_-]`).

Ekleme idempotenttir: zaten listede olan adres hata üretmez, added yalnız yeni açılan kayıt sayısını verir.
Manuel ekleme sağlayıcı (SES) hesap listesine yazılmaz (hesap-geneli liste MailMaks tarafında tutulur).

Hatalar

POST/suppressions

curl -X POST https://api.mailmaks.com/mail/api/public/v1/suppressions \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      "a@x.com",
      "b@y.com"
    ],
    "scope": "campaign",
    "customerRef": "hastane-42"
  }'

Yanıt200

{
  "added": 2
}

Kayıt sil

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

Başarıda 204 (gövdesiz); kayıt yoksa 404 not_found. Silme çift taraflıdır: kayıt hem MailMaks listesinden hem sağlayıcının (SES) hesap bastırma listesinden düşürülür — böylece bounce kaynaklı adresler gerçekten yeniden gönderilebilir olur (sağlayıcı tarafındaki silme hatası isteği başarısız etmez).

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Bastırma kaydı id'si (`sup_…`).