Gönderim API

Uygulamanız kendi alan adınızdan posta atsın: parola sıfırlama, sipariş onayı, fatura. Zaten sizde olan e-posta hesabının üstünde çalışır.

Ne işe yarar, ne işe yaramaz

Bu uç, uygulamanızın attığı posta içindir — insanın oturup yazdığı posta için değil, onun için zaten webmail ve IMAP var. Bir kullanıcı kaydolduğunda doğrulama e-postası, sipariş verildiğinde onay, ay sonunda fatura: bunları kodunuzdan tek bir HTTP isteğiyle gönderirsiniz.

Bülten ve toplu pazarlama için uygun değildir. Sınırlar buna göre konmuştur ve ticari elektronik ileti göndermek Türkiye'de ayrıca İYS kaydı gerektirir; o sorumluluk gönderendedir. Toplu gönderim yapmak istiyorsanız önce bize yazın.

Anahtar üretirken bu anahtarla ne göndereceğinizi beyan edersiniz: işlem ve bilgilendirme iletileri, ya da ticari elektronik ileti. İkincisini seçerseniz İYS kayıt bilginizi de girersiniz. Beyan anahtar başına saklanır.

Başlarken

Gönderim API'si Pro planına dahildir. Planlara bakın.

Panelde alan adınızın Gönderim API sekmesinden bir anahtar üretin. Anahtar bir kez gösterilir ve yalnızca o alan adından gönderim yapabilir. DNS doğrulaması tamamlanmamış alan adlarında anahtar üretilemez.

İlk isteğiniz

curl -X POST https://api.aser.tr/v1/emails \
  -H "Authorization: Bearer aser_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Sirketiniz <bilgi@sirketiniz.com>",
    "to": ["musteri@ornek.com"],
    "subject": "Siparişiniz alındı",
    "text": "Merhaba, siparişiniz hazırlanıyor.",
    "html": "<p>Merhaba, siparişiniz hazırlanıyor.</p>"
  }'

Yanıt: 202 ve bir id — teslimat durumunu bununla sorarsınız.

Uçlar

Uç	Ne yapar
POST /v1/emails	İleti gönderir
GET /v1/emails/{id}	Tek gönderimin durumu
GET /v1/emails	Son gönderimler
GET /v1/limits	Kalan kotanız
GET /v1/suppressions	Bastırma listesi
DELETE /v1/suppressions/{adres}	Listeden çıkarır

Gövde alanları

from — zorunlu. Anahtarın bağlı olduğu alan adında olmalı. Ad <adres> biçimi kabul edilir.
to — zorunlu. Dizgi ya da dizi; en fazla 50 alıcı.
subject — zorunlu.
text ve/veya html — en az biri zorunlu. İkisi de verilirse çok parçalı ileti kurulur.
reply_to — isteğe bağlı.
headers — isteğe bağlı. Yalnızca X- ile başlayan başlıklar geçer; From ya da Received uydurulamaz.

Durumlar

Durum	Anlamı
kuyrukta	Kabul edildi, teslim ediliyor
iletildi	Alıcı sunucu kabul etti
gecikti	Geçici hata, yeniden denenecek
dondu	Kalıcı hata; adres bastırma listesine girdi
reddedildi	Bizim tarafımızda kuyruğa alınamadı

Bastırma listesi

Kalıcı olarak geri dönen adresler otomatik olarak listeye girer ve o adrese bir daha gönderim denenmez. Bu sizi korumak için değil, herkesi korumak için: ölü adreslere yazmaya devam eden bir sunucu kara listeye düşer ve aynı altyapıdaki bütün müşterilerin teslimatı durur.

Adresin artık geçerli olduğunu biliyorsanız panelden ya da DELETE /v1/suppressions/{adres} ile çıkarabilirsiniz. Adres hâlâ geçersizse gönderim yine döner ve tekrar listeye girer.

Sınırlar

Anahtar başına varsayılan olarak saatte 200, günde 1.000 ileti. Sınır aşıldığında 429 döner ve yanıtta hangi pencerede olduğunuz yazar. Daha yüksek hacim gerekiyorsa bize yazın — sınırı büyütmek altyapı tarafında karar gerektiriyor, çünkü hepimiz aynı IP'den gönderiyoruz.

Kimlik doğrulama nasıl çalışıyor

Alıcının gördüğü gönderen sizsiniz ve ileti sizin alan adınızın DKIM anahtarıyla imzalanır. Zarf göndericisi (geri dönüş adresi) bizim gonderim.aser.tr adresimizdir; geri dönenleri yakalayıp bastırma listesini oluşturabilmemiz için. DMARC bozulmaz, çünkü DKIM sizin alan adınızla hizalıdır.

Hata biçimi

{"error": {"type": "gunluk_sinir",
           "message": "Günlük gönderim sınırı (1000) aşıldı.",
           "limit": 1000, "used": 1000, "window": "24h"}}

401 anahtar geçersiz · 400 istek hatalı · 422 bütün alıcılar bastırılmış · 429 sınır aşıldı · 502 kuyruğa alınamadı.