Bilgi bankası
E-posta API’si
Çağrı başına bir ya da yüz ileti gönderin, şimdi ya da sonra, ve iki kez göndermeden yeniden deneyin.
Ayrıntılar
- POST /emails bir ileti, POST /emails/batch ise birbirinden bağımsız 100 iletiye kadar gönderir. Toplu gönderim asla hep ya da hiç değildir: 7. öğedeki hatalı adres yalnızca 7. öğeyi başarısız kılar, kalanlar yine gider ve yanıt her öğeyi ayrı bildirir.
- İçerik tek bir kaynaktan gelir: html ve/veya text, kimlik ya da slug ile kayıtlı bir şablon (metin başkasına aitse sürümünü sabitleyin) ya da mevcut bir taslak. En fazla 10 etiket de eklenir ve her okumada geri döner.
- scheduledAt bir iletiyi ISO 8601 zamanı ya da PT1H gibi bir süreyle 365 güne kadar bekletir. cancellableForSeconds anında gönderime 900 saniyeye kadar geri alma süresi tanır. İkisi de gidene kadar iptal edilebilir, zamanlanmış gönderim de yeniden zamanlanabilir.
- Her gönderim, hiçbir şey yola çıkmadan önce ayrılan bir Idempotency-Key taşır; bu yüzden zaman aşımından sonraki yeniden deneme ilk sonucu Idempotency-Replayed: true ile döndürür. Aynı anahtar farklı içerikle gelirse idempotency_key_reuse olarak reddedilir.
- Her gönderimin kabul edildiği andan itibaren bir msg_ kimliği vardır. GET /emails/{id} onu okur, /events her alıcının izini, /tracking ise açılma ve tıklamaları verir.
- translate ekleyin, ileti alıcının dilinde teslim edilir. Çeviri istek kabul edilirken yapılır; böylece zamanlanmış gönderim onayladığınız metni taşır, çeviri üretilemezse de özgün metne dönmek yerine gönderim reddedilir.
- Ekler: en fazla 20 dosya, gömülü olanlar toplamda 5 MB’a kadar. Daha büyük bir dosya, çalışma alanındaki bir dosyanın kimliği verilerek gönderilir ve indirme bağlantısı olarak gider.
- Eksik olanlar: henüz test modu yok, bu yüzden her anahtar gerçekten teslim eder; gönderim kaydında da geri dönme durumu yok. Geri dönme konuda etiketlenir ve email.bounced webhook’u olarak bildirilir, GET /emails ise sent göstermeye devam eder.
- Engelleme listesi, yani Ayarlar’daki Engellenen adresler, API’de de var. GET /suppressions onu bir arama ve bir neden süzgeciyle okur, POST /suppressions bir adresi elle engeller, DELETE /suppressions/{id} ise bir adrese yeniden izin verir; kalıcı geri dönen bir adres hariç, o kalır. SDK ve MCP sunucusu da aynısını yapar ve her değişiklik suppression.added ya da suppression.removed web kancasını tetikler.