Ukuran file di disk hanyalah satu bagian dari pesan yang dihasilkan. Header MIME dan encoding base64 menambah overhead, sehingga file yang sesuai dengan batas yang diiklankan penyedia tetap bisa membuat pesan terlalu besar.
Apa yang membuat lampiran lebih besar saat dikirim?
Encoding Base64 menambah sekitar sepertiga ukuran file biner sebelum line break dan header MIME ditambahkan. Email membawa file ter-encode tersebut sebagai bagian MIME, bersama isi pesan dan header.
Sebagai contoh, file biner 12 MB menjadi sekitar 16 MB base64 sebelum line break, header, dan isi pesan ditambahkan. Anggap ini sebagai perkiraan, bukan batas penyedia.
Batas mana yang harus saya gunakan?
Gunakan batas terkecil di antara layanan pengiriman Anda, penyedia penerima, dan jalur di antara keduanya. Penyedia mempublikasikan batas yang berbeda dan dapat mengubahnya. Tautkan ke batas terkini penyedia daripada meng-hardcode satu angka universal.
Jika file mendekati batas, gunakan tautan unduhan terautentikasi sebagai gantinya. Pesan tetap kecil. Anda dapat mengatur kedaluwarsa atau mencabut akses secara terpisah dari email.
| Batasan | Yang dibatasi | Contoh konsekuensi |
|---|---|---|
| Batas per lampiran | Satu file atau field lampiran | API menolak item tersebut |
| Batas seluruh pesan | Isi, header, dan lampiran ter-encode | Pengirim menolak pesan yang dihasilkan |
| Transfer cloud-link | Layanan unduhan tertaut | Penerima mengikuti kebijakan akses terpisah |
Bantuan personal Gmail menyebutkan batas total lampiran 25 MB. Administrator workspace dapat menetapkan batas berbeda untuk akun kerja dan sekolah. Perlakukan keduanya sebagai nilai spesifik penyedia.
Bagaimana seharusnya API menangani file besar?
Periksa ukuran pesan ter-encode sebelum mengirim. Tolak atau ganti lampiran yang melebihi batas dengan tautan unduhan yang jelas. Beri tahu pengguna file mana yang menyebabkan keputusan tersebut. Jangan coba lagi mengirim pesan yang melebihi batas tanpa perubahan.
Pastikan nama lampiran dan content type akurat. Penyedia penerima dapat menolak pesan karena ukuran total, tipe file yang diblokir, atau kebijakan yang diterapkan pada tautan.
Bagaimana Bird menangani lampiran?
Atur array attachments pada request POST /v1/email/messages Anda. Periksa panduan lampiran untuk anggaran pesan yang dihasilkan Bird saat ini. Pengiriman HTTP yang melebihi batas mengembalikan 413. Jaga agar konten lampiran mentah jauh di bawah anggaran yang didokumentasikan agar isi pesan dan pembungkus MIME muat.
Ringkasan
- Batas mencakup pesan ter-encode, isi, header, dan lampiran.
- Base64 menambah sekitar sepertiga ukuran file biner.
- Periksa setiap penyedia dalam jalur pengiriman.
- Tautan unduhan menghindari kegagalan batas lampiran untuk file besar.