Batasan

Sekilas

• 1/detik

  Permintaan API, per alamat

  Poll sekali per detik adalah pola yang dimaksudkan.

• 5hari

  Retensi pesan

  Sejak kedatangan, dibaca atau tidak. Batas keras.

• 5MB

  Ukuran pesan maksimum

  Ditolak saat SMTP, sehingga pengirim diberi tahu.

• ∞

  Alamat per domain

  Tidak ada yang dibuat di muka, jadi tidak ada yang dihitung.

• 200

  Pesan yang dikembalikan per panggilan

  Default 50. Ini membatasi satu respons, bukan mailbox: next menelusuri sisanya, berapa pun jumlahnya.

• 0

  Pesan keluar

  Tidak ada endpoint pengiriman. Memang dirancang begitu.

Batas laju

Satu permintaan per detik, per alamat. Batas ini berlaku per kotak surat, bukan per IP, jadi CI runner bersama yang mem-polling dua puluh kotak surat berbeda tidak akan bersaing dengan dirinya sendiri.

Melewati batas, Anda akan mendapat 429 dengan header Retry-After dalam detik bulat. Tidak ada kuota harian, tidak ada kuota bulanan, dan tidak ada kredit burst yang perlu dikelola.

Ada batas kedua, dan disebutkan di sini alih-alih dibiarkan ditemukan sendiri: 1200 permintaan per menit dari satu alamat sumber. Itu persis contoh dua puluh mailbox per detik di atas, jadi otomatisasi biasa tidak akan pernah mencapainya — batas ini ada agar satu host tidak bisa menjelajahi sepuluh ribu alamat per detik.

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

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

Gunakan penundaan berdasarkan Retry-After, bukan jeda tetap. Jika batasnya berubah suatu saat, kode yang membaca header ini akan tetap berfungsi.

Ukuran pesan

Pesan hingga 5 MB, termasuk lampiran. Batas ini diberlakukan oleh server mail selama percakapan SMTP, dan itu penting: server pengirim diberi tahu pada saat mencoba, dan melaporkan kegagalan nyata ke penggunanya, alih-alih pesan menghilang begitu saja.

Apa yang dihitung

Seluruh pesan terenkode — header, isi, dan setiap lampiran setelah pengkodean MIME. Base64 memperbesar ukuran biner sekitar sepertiga, jadi berkas 20 MB sudah mendekati batas.

Apa yang terjadi di jalur pengiriman

552 pada saat SMTP. Pesan tersebut tidak pernah disimpan dan tidak pernah muncul di kotak surat.

Lampiran per pesan

Tidak dibatasi secara terpisah. Yang penting adalah totalnya.

Retensi

Pesan dihapus 5 hari setelah tiba, dibaca atau tidak, dan hitungan waktu dimulai sejak pengiriman, bukan sejak pertama kali dibaca.

Setiap pesan membawa expires_at, jadi klien tidak perlu menghitung tanggal itu atau melacak kebijakannya.

Ini batas keras, bukan pengaturan: tidak ada parameter, paket, atau akun yang memperpanjangnya. Jika ada yang harus bertahan lebih lama dari jendela waktu ini, ambil dan simpan di sisi Anda.

Alamat dan domain

Alamat per domain

Tak terbatas, dan tidak dihitung. Karena mailbox tidak pernah benar-benar dibuat, tidak ada daftar yang bisa bertambah.

Aturan bagian-lokal

Satu hingga 64 karakter: huruf, angka, titik, tanda hubung, garis bawah, dan tanda tambah. Harus dimulai dan diakhiri dengan huruf atau angka. Selain itu ditolak sebelum mencapai server mail, di browser dan sekali lagi di server.

Alamat plus

name+tag@domain adalah kotak masuk yang berbeda di sini, bukan alias dari name@domain. Itu disengaja — tag adalah cara orang memisahkan pendaftaran, dan menggabungkannya akan menyatukan kotak masuk yang seharusnya tetap terpisah.

Huruf besar/kecil

Semua huruf diubah menjadi huruf kecil. Name@ dan name@ adalah mailbox yang sama.

Domain kustom

Tidak ada batas berapa banyak yang Anda arahkan ke sini. Masing-masing memerlukan rekaman MX-nya sendiri.

Penggunaan wajar

Tidak ada kuota yang bisa dibeli untuk melewati batas ini, dan tidak ada paket yang menaikkan angka-angka ini. Yang ada sebagai gantinya: jika satu sumber membuat layanan menjadi lebih buruk bagi semua orang lain, sumber itu dihentikan.

Polling massal

Ribuan mailbox yang dipolling setiap detik dari satu sumber akan dibatasi di edge sebelum mencapai API.

Banjir surat

Host pengirim yang membuka jumlah koneksi SMTP yang tidak wajar akan diblokir sementara selama sepuluh menit. Pengirim normal tidak akan pernah mendekati batas itu.

Menggunakan kami sebagai relay

Tidak mungkin, bukan sekadar dilarang: server surat hanya menerima pesan yang ditujukan ke domain yang dihosting di sini, jadi tidak bisa meneruskan apa pun ke mana pun.

Tidak ada dari ini yang ditujukan untuk otomatisasi biasa. Polling sekali per detik, sepanjang hari, di ribuan kotak surat — itulah penggunaan yang dimaksudkan, bukan batas ekstremnya.