Dokümantasyon

Hesabınızı dakikalar içinde gönderime hazır hâle getirin. REST API ile abonelerinizi kendi sisteminizden yönetin, webhook'larla olayları anlık alın.

1
Alan adı ekleyin ve doğrulayın
Panel → Alan adları → Ekle. Gösterilen SPF, DKIM (mx1._domainkey), DMARC ve bounce alt alan adı kayıtlarını DNS sağlayıcınıza girin, 'DNS'i doğrula'ya basın.
2
Liste oluşturun ve aboneleri aktarın
Panel → Listeler. CSV dosyasında 'email' sütunu zorunludur; ad, soyad ve diğer sütunlar özel alan olur. Yazım hatalı ve geçersiz adresler içe aktarmada ayıklanır.
3
Kampanya gönderin
Panel → Kampanyalar → Yeni. Şablon seçin, kişiselleştirin, önce kendinize test maili gönderin, sonra zamanlayın.

Örnek istek

Abone ekleme. Adres zaten varsa güncellenir; bastırma listesindeyse eklenmez ve yanıtta suppressed: true döner.

curl -X POST https://t.winnermailing.com/v1/subscribers \
  -H "Authorization: Bearer wm_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ayse@example.com",
    "first_name": "Ayşe",
    "attributes": { "city": "İstanbul" },
    "lists": ["<list-id>"],
    "double_opt_in": true
  }'

Uç noktalar

Yöntem	Yol	Açıklama
`GET`	`/v1/me`	Anahtarın bağlı olduğu müşteri ve plan bilgisi
`GET`	`/v1/lists`	Listeleri getirir
`POST`	`/v1/lists`	Liste oluşturur
`POST`	`/v1/subscribers`	Abone ekler ya da günceller
`POST`	`/v1/subscribers/import`	Toplu içe aktarma (istek başına 1.000)
`GET`	`/v1/subscribers`	Aboneleri listeler (email, status, limit, offset)
`GET`	`/v1/subscribers/:id`	Tek abone
`DELETE`	`/v1/subscribers/:id`	Aboneyi çıkarır ve bastırma listesine alır
`GET`	`/v1/campaigns`	Kampanyalar ve özet sayaçlar
`GET`	`/v1/campaigns/:id`	Kampanya raporu

Webhook

Panel → Webhook'lar sayfasından bir URL ve olay türleri seçin. Her çağrı, webhook sırrıyla HMAC-SHA256 imzalanır; başarısız teslimatlar artan aralıklarla yeniden denenir. Olay türleri:

subscribesentopenclickbouncecomplaintunsubscribe

Kimlik doğrulama

Tüm API istekleri 'Authorization: Bearer <api anahtarı>' başlığı ister. Anahtarlar Panel → API anahtarları sayfasından üretilir ve yalnızca üretildiği anda gösterilir.

Hız limitleri

Anahtar başına dakikada 600 istek. Toplu içe aktarma uç noktası istek başına en fazla 1.000 abone kabul eder.

Onaylı abonelerinize bugün ulaşın

Ücretsiz planla başlayın: 2.000 mail/ay, 500 abone, kredi kartı gerekmez.

Panele giriş