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–5/sn
Adres başına API istekleri
Anahtarsız bir tane; ücretli bir plandan bir anahtarla 2, 3 veya 5. Saniyede bir yoklama, öngörülen kullanım biçimidir.
60/dk
Dakikalık ücretsiz API isteği
IP adresi başına, anahtarsız. Ücretli planlarda dakikalık sınır yoktur.
1.000/gün
Günlük ücretsiz API isteği
IP adresi başına; 00:00 UTC'de sıfırlanır. Ücretli planlarda günlük sınır yoktur.
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:
nextkaç 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ırları
Ücretsiz, anahtarsız: IP adresi başına dakikada 60 ve günde 1.000 istek. Bir posta kutusuna yapılan her çağrı sayılır — listeleme, ileti okuma, HTML gövdesi, ek, silme — her MCP araç çağrısı da öyle. Gün 00:00 UTC'de sıfırlanır.
Bu sınırın içinde adres başına saniyede bir okuma geçerlidir: bir posta kutusunu saniyede bir yoklamak amaçlanan ritimdir.
Ücretsiz bir API anahtarıyla aynı kota IP adresinizi değil hesabınızı izler — çağrılarınız bir CI çalıştırıcısı gibi değişen adreslerden geldiğinde kullanışlıdır. Ücretsiz bir hesabın bir anahtarı vardır ve okuduğu kutular gelen kutularınızda listelenir. Ücretsiz anahtar oluştur
Ücretli planlarda dakikalık sınır da günlük sınır da yoktur. Ücretli bir planın anahtarını Authorization: Bearer olarak gönderin; geriye yalnızca planın adres başına hızı kalır: her alan adında saniyede 2, 3 veya 5 istek, hesap başına sayılır. Premium planın başlangıç fiyatı ayda $12,99. Planları gör
Bu sitedeki gelen kutusu ücretsiz API kotanızı tüketmez: açık bıraktığınız sayfa, ihtiyacınız olduğu sürece yeni postayı denetlemeye devam eder.
Bir sınırı aştığınızda, tam saniye cinsinden bir Retry-After başlığıyla birlikte 429 alırsınız: dakikalık sınır ya da adres sınırı için rate_limited, günlük sınır için ise UTC gece yarısına kalan süreyle birlikte daily_limit_reached. Her ücretsiz yanıt ne kadar hakkınız kaldığını söyler: dakika için X-RateLimit-Remaining, gün için X-RateLimit-Daily-Remaining.
HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 0
Content-Type: application/json
{
"error": "daily_limit_reached",
"message": "free daily limit reached: 1000 requests a day per IP address, resets at 00:00 UTC — paid plans have no daily cap",
"upgrade": { "from": "$12.99/month", "url": "https://grabmail.io/pricing", … }
}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
- Kodlanmış mesajın tamamı — başlıklar, gövde ve MIME kodlamasından sonraki her ek. Base64, bir ikiliyi yaklaşık üçte bir oranında büyütür, bu yüzden yaklaşık 3,5 MB'lık bir dosya sınırı zaten doldurur.
- 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
- Yirmi. Pratikte boyut sınırına önce ulaşılır — ama yirmiden fazla dosya adlı parça taşıyan bir mesaj ilk yirmisini tutar.
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@domainburadaname@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@ilename@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.