Email

Wat is een limiet voor de grootte van e-mailbijlagen?

Een limiet voor de grootte van e-mailbijlagen is het grootste gecodeerde bericht dat een ontvangende provider accepteert, inclusief de berichttekst en bijlage-overhead.

De bestandsgrootte op schijf is slechts één onderdeel van het gegenereerde bericht. MIME-headers en base64-codering voegen overhead toe, waardoor een bestand dat binnen de gepubliceerde limiet van een provider past het bericht alsnog te groot kan maken.

Waardoor wordt een bijlage groter tijdens verzending?

Base64-codering voegt ongeveer een derde toe aan een binair bestand, nog vóór regeleinden en MIME-headers worden toegevoegd. E-mail verzendt dat gecodeerde bestand als een MIME-onderdeel, naast de berichttekst en headers.

Een binair bestand van 12 MB wordt bijvoorbeeld ongeveer 16 MB aan base64 vóór regeleinden, headers en berichttekst. Beschouw dat als een schatting, niet als een providerlimiet.

Welke limiet moet je gebruiken?

Gebruik de kleinste limiet van je verzenddienst, de provider van de ontvanger en het pad daartussen. Providers publiceren verschillende limieten en kunnen die wijzigen. Link naar de actuele limiet van de provider in plaats van één universeel getal hard te coderen.

Als een bestand dicht bij de limiet zit, plaats het dan achter een geauthenticeerde downloadlink. Het bericht blijft klein. Je kunt toegang laten verlopen of intrekken, onafhankelijk van de e-mail.

GrensWat het beperktVoorbeeldgevolg
BijlageplafondEén bestand of bijlageveldDe API weigert dat item
BerichtplafondBerichttekst, headers en gecodeerde bijlagenDe afzender weigert het gegenereerde bericht
CloudlinkoverdrachtDe gekoppelde downloaddienstDe ontvanger volgt een apart toegangsbeleid

Gmail's persoonlijke help beschrijft een totale bijlagelimiet van 25 MB. Werkruimtebeheerders kunnen andere limieten instellen voor werk- en schoolaccounts. Beschouw beide als providerspecifieke waarden.

Hoe moet een API grote bestanden verwerken?

Controleer de gecodeerde berichtgrootte vóór verzending. Weiger of vervang een te grote bijlage door een duidelijke downloadlink. Vertel de gebruiker welk bestand de oorzaak was. Probeer een ongewijzigd te groot bericht niet opnieuw te verzenden.

Houd bijlagenamen en contenttypes nauwkeurig. De provider van de ontvanger kan een bericht weigeren vanwege de totale grootte, een geblokkeerd bestandstype of een beleid dat op de link van toepassing is.

Hoe verwerkt Bird bijlagen?

Stel de attachments-array in op je POST /v1/email/messages-verzoek. Raadpleeg de bijlagegids voor het huidige budget voor gegenereerde berichten van Bird. Een te grote HTTP-verzending retourneert 413. Houd de ruwe bijlage-inhoud ruim onder het gedocumenteerde budget, zodat de berichtteksten en MIME-verpakking passen.

Samengevat

  • De limiet dekt het gecodeerde bericht, de berichttekst, headers en bijlagen.
  • Base64 voegt ongeveer een derde toe aan de grootte van een binair bestand.
  • Controleer elke provider in het afleverpad.
  • Een downloadlink voorkomt fouten door bijlagegrootte bij grote bestanden.

Bouw op hetzelfde netwerk.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra u een betaalmethode toevoegt en een afzender verifieert.

Begin met één kanaal.
Voeg de rest toe wanneer je er klaar voor bent.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.

Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe:

Cursor