Ana Sayfa › REST API entegrasyonu

SenderTR REST API ile e-posta gönderimi

REST API, SMTP kurmadan doğrudan HTTP üzerinden e-posta göndermenizi sağlar. Teslim durumu webhook ile uygulamanıza döner; kuyruk altyapısı kurmanız gerekmez.

Ücretsiz Başlayın Fiyatları Görün

Kredi kartı gerekmez · 1.000 e-posta kredisi hediye

REST API, uygulamanızdan HTTP isteğiyle e-posta göndermenizi sağlar. SMTP'ye göre iki avantajı vardır: bağlantı yönetimi ve kuyruk gerektirmez, ve yanıt olarak mesaj kimliği döner — o kimliği webhook olaylarıyla eşleştirip teslim durumunu kendi veritabanınızda takip edebilirsiniz.

SMTP ayarları

Ayar	Değer
Sunucu (host)	smtp.sendertr.com
Port	587
Şifreleme	STARTTLS / TLS
Kimlik doğrulama	Gerekli (kullanıcı adı + şifre)
Kullanıcı adı	Panelden aldığınız SMTP kullanıcı adı
Şifre	Panelden aldığınız SMTP şifresi
Gönderen adresi	Doğrulanmış alan adınızdaki bir adres

Kullanıcı adı ve şifreyi panelde Transactional → SMTP Bilgileri bölümünden alırsınız. Şifre yalnızca bir kez gösterilir.

Kurulum adımları

API anahtarı oluşturun — Panelde Transactional bölümünden bir API anahtarı üretin. Anahtar yalnızca bir kez gösterilir; güvenli saklayın ve istemci tarafına (tarayıcı, mobil uygulama) koymayın.
Kimlik doğrulamayı ayarlayın — İsteklerinize X-Api-Key başlığını ekleyin veya Bearer token olarak gönderin.
Gönderim isteğini yapın — JSON gövdeyle alıcı, konu ve içerik gönderin. Gönderen adresi doğrulanmış alan adınızda olmalıdır.
Webhook adresinizi tanımlayın — Panelde webhook URL'nizi girin; teslim, erteleme, bounce, gönderilemedi, açılma, tıklama ve şikâyet olayları o adrese POST edilir.
Olayları mesaj kimliğiyle eşleştirin — Gönderim yanıtındaki mesaj kimliğini saklayın ve webhook olaylarını bu kimlikle kendi kayıtlarınıza bağlayın.

curl -X POST https://api.sendertr.com/v1/send \
  -H "X-Api-Key: <anahtarınız>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "musteri@ornek.com",
    "subject": "Siparişiniz alındı",
    "html": "<p>Teşekkürler!</p>"
  }'

# Tam referans ve tüm alanlar: docs.sendertr.com

Webhook olayları

Panelde tanımladığınız adrese şu olaylar POST edilir: delivered (alıcı sunucu kabul etti), deferred (alıcı geçici olarak erteledi), bounced (alıcı reddetti), failed (gönderilemedi), expired (ömrü doldu), opened, clicked, complained (şikâyet) ve unsubscribed. Her olay gönderim sırasında döndürülen mesaj kimliğini ve tekil bir olay kimliğini (X-Event-Id) taşır.

Webhook uç noktanızı imza doğrulamasıyla koruyun ve olayları idempotent işleyin — aynı olay ağ koşullarına bağlı olarak birden çok kez ulaşabilir. Teslim edilemeyen olaylar panelde ölü mektup olarak bekler ve tek tıkla yeniden gönderilir.

Geliştirici kolaylıkları

Idempotency-Key — aynı anahtarla yinelenen gönderim isteği ikinci bir e-posta oluşturmaz; ağ kesintisinde güvenle tekrar deneyin.
Sürümlü işlemsel şablonlar — içeriği API'de bir kez kaydedin, gönderimde yalnızca şablon anahtarı ve değişkenleri geçin; eski sürüme tek çağrıyla dönün.
Olay zaman çizelgesi ve iptal — her ileti için kuyruktan teslime tüm adımlar; kuyruktaki ileti gönderilmeden iptal edilebilir, ileri tarihe planlanabilir.
Resmî PHP ve Node.js SDK, OpenAPI şeması — diğer diller için şemadan istemci üretin. Her yanıtta X-Request-Id; istekleriniz panelde API günlüğünde.

Anahtar güvenliği

API anahtarı sunucu tarafında saklanmalıdır. Tarayıcı JavaScript'ine, mobil uygulama paketine veya herkese açık bir depoya koymayın; anahtarı ele geçiren biri sizin adınıza e-posta gönderebilir. Anahtarlar panelden iptal edilip yenilenebilir.

Kurulumdan sonra mutlaka yapın

Alan adınızı doğrulayın. DKIM ve DMARC kayıtları eklenmeden gönderim yapılamaz; SPF isteğe bağlıdır çünkü Return-Path SenderTR alan adındadır ve DMARC DKIM ile geçer. Panel kayıtları üretir, siz DNS'e eklersiniz. Kontrol: teslimat kontrolü aracı.
Test e-postası gönderin. Gmail, Outlook ve bir mobil istemcide açın; bağlantıları tıklayın.
Gönderen adresini doğrulanmış alan adınızdan seçin. Gmail veya Hotmail adresinden gönderim yapmayın — DMARC doğrulaması başarısız olur.
Hacmi kademeli artırın. Yeni bir alan adıyla başlıyorsanız ilk günlerde düşük hacimle gidin. Bkz. IP warmup.

Sık sorulanlar

API mi SMTP mi kullanmalıyım?

Kuyruk altyapınız varsa ve mevcut kodunuz SMTP kullanıyorsa SMTP daha az değişiklik gerektirir. Teslim durumunu kendi sisteminizde izlemek istiyorsanız veya kuyruk kurmak istemiyorsanız API daha uygundur.

Hız sınırı var mı?

Evet, API uçları dakika bazında sınırlıdır. Sınıra takılırsanız 429 yanıtı alır ve kısa bir bekleme sonrası yeniden denersiniz.

Toplu gönderim API'den yapılır mı?

API işlemsel gönderim içindir. Kampanya ve bülten gönderimi panel üzerinden liste ve segmentlerle yapılır; ikisi ayrı IP havuzlarından çıkar.

Dokümantasyon nerede?

docs.sendertr.com adresinde: kimlik doğrulama, tüm uçlar, alan referansı ve webhook yükleri örneklerle anlatılıyor.

İlgili rehberler

İşlemsel e-posta: SMTP relay ve API SaaS için e-posta pazarlaması Hard bounce, soft bounce ve suppression

Kurulumu beş dakikada tamamlayın

Hesap açın, SMTP bilgilerinizi alın, ilk e-postanızı gönderin. 1.000 e-posta kredisi hediye.

Ücretsiz Hesap Açın

Kredi kartı gerekmez · Kurulum ücreti yok