Krediler

Kredi kuralları: işlemsel mesajda kredi istek anında, kampanyada dispatch anında alıcı başına düşer; gönderilemeyen zarf/alıcı için iade edilir (creditsRefunded / refund hareketi).

Uçlar (2)

GET/balanceBakiye
GET/credits/historyKredi hareketleri

Bakiye

GET/public/v1/balancescoperead

balance: kalan kredi. Kredi kaydı olmayan hesap hata değil sıfır bakiye görür.
expiresAt (opsiyonel): en yakın vadeli paketin son kullanma tarihi; yoksa yazılmaz.
dailyQuota (opsiyonel): günlük kota; tanımsızsa (sınırsız) yazılmaz. dailyUsed: bugünkü kullanım.

Hatalar

GET/balance

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

Yanıt200

{
  "balance": 9800,
  "expiresAt": "2027-01-01T00:00:00.0000000Z",
  "dailyQuota": null,
  "dailyUsed": 200
}

Kredi hareketleri

GET/public/v1/credits/historyscoperead

Sorgu parametreleri

Ad	Tip	Zorunlu	Açıklama
`page`	integer	hayır	Sayfa numarası, ≥ 1.
`pageSize`	integer	hayır	1–100 (varsayılan 20).

type: purchase | send | refund | expire. amount işaretli deltadır: purchase/refund pozitif, send/expire negatif.
campaignId ve note boşsa yazılmaz.

Hatalar

GET/credits/history

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

Yanıt200

{
  "items": [
    {
      "id": "…",
      "type": "send",
      "amount": -3,
      "campaignId": "cmp_…",
      "createdAt": "…",
      "note": "…"
    }
  ],
  "totalCount": 12,
  "page": 1,
  "pageSize": 20
}