Sınırlar

Sınırlanan her şey, tek bir yerde. Keşfedilmek yerine yayımlanmış — sürpriz halde karşınıza çıkan bir sınır, belgelerdeki bir hatadır.

Bir bakışta

1/sn
Adres başına API istekleri
Saniyede bir yoklama, öngörülen kullanım biçimidir.
5gün
Mesaj saklama süresi
Varıştan itibaren, okunmuş ya da okunmamış. Kesin sınır.
5MB
Azami mesaj boyutu
SMTP aşamasında reddedilir, böylece gönderen bilgilendirilir.
∞
Alan adı başına adresler
Önceden hiçbir şey oluşturulmaz, dolayısıyla hiçbir şey sayılmaz.
200
Çağrı başına dönen mesaj
Varsayılan 50. Bu, tek bir yanıtı sınırlar, gelen kutusunu değil: next kaç tane olursa olsun kalanların sayfalarını gezdirir.
0
Giden mesajlar
Gönderim yapan bir uç nokta yoktur. Bu tasarım gereğidir.

Hız sınırı

Adres başına saniyede bir istek. Sınır IP başına değil posta kutusu başınadır, bu yüzden yirmi farklı posta kutusunu yoklayan paylaşımlı bir CI çalıştırıcısı kendisiyle yarışmaz.

Sınırı aştığınızda, tam saniye cinsinden bir Retry-After başlığıyla birlikte 429 alırsınız. Günlük kota, aylık kota veya yönetilecek bir patlama (burst) kredisi yoktur.

İkinci bir sınır daha var ve bu, keşfedilmeye bırakılmak yerine burada belirtiliyor: tek bir kaynak adresten dakikada 1200 istek. Bu, yukarıdaki saniyede yirmi kutu örneğiyle tam olarak örtüştüğü için sıradan bir otomasyon buna asla ulaşmaz — bu sınır, tek bir makinenin saniyede on bin adresi tarayamaması içindir.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error":   "rate_limited",
  "message": "one request per second, per address"
}

Sabit bir bekleme yerine Retry-After'a göre hız kesin. Sınır bir gün değişirse, bu başlığı okuyan kod çalışmaya devam eder.

Mesaj boyutu

Ekler dahil en fazla 5 MB. Bu sınır, SMTP görüşmesi sırasında posta sunucusu tarafından uygulanır; bu önemlidir, çünkü gönderen sunucuya tam denediği anda bildirilir ve mesaj sessizce kaybolmak yerine kullanıcısına gerçek bir hata bildirilir.

Neler sayılır: MIME kodlamasından sonraki tüm kodlanmış mesaj — başlıklar, gövde ve her ek. Base64 bir ikili dosyayı yaklaşık üçte bir oranında büyütür, bu yüzden 20 MB'lık bir dosya sınıra yakındır.
Hat üzerinde neler oluyor: SMTP anında bir 552. İleti asla saklanmaz ve posta kutusunda hiçbir zaman görünmez.
İleti başına ekler: Ayrı bir üst sınırı yok. Önemli olan toplamdır.

Saklama süresi

Bir ileti, gelişinden 5 gün sonra silinir; okunmuş olsun ya da olmasın, ve süre ilk okunduğu anda değil teslimatla başlar.

Her mesaj bir expires_at taşır, böylece istemcinin bu tarihi hesaplaması veya politikayı takip etmesi gerekmez.

Bu kesin bir sınırdır, bir ayar değil: hiçbir parametre, plan veya hesap onu uzatmaz. Bir şeyin bu süreyi aşması gerekiyorsa, kendi tarafınızda alıp saklayın.

Adresler ve alan adları

Alan adı başına adresler: Sınırsız ve sayılmaz. Bir posta kutusu asla oluşturulmadığından büyüyecek bir liste de yoktur.
Yerel kısım kuralları: 1 ile 64 karakter arası: harfler, rakamlar, nokta, tire, alt çizgi ve artı işareti. Bir harf veya rakamla başlamalı ve bitmelidir. Bunların dışındaki her şey posta sunucusuna ulaşmadan önce, önce tarayıcıda sonra tekrar sunucuda reddedilir.
Artı işaretli adresleme: name+tag@domain burada name@domain'ın bir takma adı değil, ayrı bir posta kutusudur. Bu bilinçli bir tercihtir — etiketler insanların kayıtları ayırma yöntemidir ve bunları birleştirmek, ayrı kalması amaçlanan kutuları birbirine karıştırırdı.
Büyük/küçük harf: Her şey küçük harfe çevrilir. Name@ ile name@ aynı gelen kutusudur.
Özel alan adları: Buraya kaç tanesini yönlendirdiğinizin sınırı yok. Her birinin kendi MX kaydı gerekir.

Adil kullanım

Satın alarak aşabileceğiniz bir kota yok ve bu sayıları yükselten bir plan da yok. Bunun yerine şu var: tek bir kaynak hizmeti herkes için kötüleştirirse durdurulur.

Toplu yoklama: Tek bir kaynaktan saniyede binlerce posta kutusunun sorgulanması, API'ye ulaşmadan önce sınırda kısıtlanır.
Posta seli: Makul olmayan sayıda SMTP bağlantısı açan bir gönderen sunucu on dakika beklemeye alınır. Normal göndericiler buna asla yaklaşmaz.
Bizi aktarıcı olarak kullanmak: Yasak olmaktan çok imkânsız: posta sunucusu yalnızca burada barındırılan alan adlarına gönderilen mesajları kabul eder, dolayısıyla hiçbir yere iletemez.

Bunların hiçbiri sıradan otomasyon için tasarlanmadı. Günün her saati, binlerce posta kutusunda saniyede bir sorgulama — amaçlanan kullanım budur, sınırı değil.