Die Dateigröße auf der Festplatte ist nur ein Teil der erzeugten Nachricht. MIME-Header und Base64-Kodierung erzeugen Overhead, sodass eine Datei, die unter das beworbene Limit eines Anbieters passt, die Nachricht trotzdem zu groß machen kann.
Was macht einen Anhang beim Versand größer?
Base64-Kodierung fügt einer Binärdatei etwa ein Drittel hinzu, bevor Zeilenumbrüche und MIME-Header dazukommen. Die E-Mail transportiert diese kodierte Datei als MIME-Part zusammen mit dem Nachrichtentext und den Headern.
Beispiel: Eine 12 MB große Binärdatei wird vor Zeilenumbrüchen, Headern und Nachrichtentext zu etwa 16 MB Base64. Betrachten Sie das als Schätzwert, nicht als Anbieterlimit.
Welches Limit sollte ich verwenden?
Verwenden Sie das kleinste Limit unter Ihrem Versanddienst, dem Anbieter des Empfängers und dem Übertragungsweg dazwischen. Anbieter veröffentlichen unterschiedliche Limits und können sie ändern. Verlinken Sie auf das aktuelle Limit des Anbieters, anstatt eine einzelne universelle Zahl fest einzuprogrammieren.
Wenn eine Datei nahe am Limit liegt, stellen Sie sie stattdessen hinter einen authentifizierten Download-Link. Die Nachricht bleibt klein. Sie können den Zugriff unabhängig von der E-Mail ablaufen lassen oder widerrufen.
| Grenze | Was sie begrenzt | Beispielfolge |
|---|---|---|
| Anhangslimit | Eine Datei oder ein Anhangsfeld | Der API lehnt dieses Element ab |
| Gesamtnachrichtenlimit | Text, Header und kodierte Anhänge | Der Absender lehnt die erzeugte Nachricht ab |
| Cloud-Link-Transfer | Der verlinkte Download-Dienst | Der Empfänger unterliegt einer separaten Zugriffsrichtlinie |
Die persönliche Hilfe von Gmail beschreibt ein Gesamtanhangslimit von 25 MB. Workspace-Administratoren können für Arbeits- und Schulkonten andere Limits festlegen. Behandeln Sie beide als anbieterspezifische Werte.
Wie sollte eine API mit großen Dateien umgehen?
Prüfen Sie die kodierte Nachrichtengröße vor dem Senden. Lehnen Sie einen zu großen Anhang ab oder ersetzen Sie ihn durch einen eindeutigen Download-Link. Teilen Sie dem Benutzer mit, welche Datei die Entscheidung ausgelöst hat. Senden Sie eine unverändert zu große Nachricht nicht erneut.
Achten Sie auf korrekte Dateinamen und Content-Types bei Anhängen. Der Anbieter des Empfängers kann eine Nachricht wegen der Gesamtgröße, eines blockierten Dateityps oder einer auf den Link angewandten Richtlinie ablehnen.
Wie verarbeitet Bird Anhänge?
Setzen Sie das attachments-Array in Ihrer POST /v1/email/messages-Anfrage. Prüfen Sie im Leitfaden für Anhänge das aktuelle Budget für erzeugte Nachrichten von Bird. Ein zu großer HTTP-Versand gibt 413 zurück. Halten Sie den rohen Anhangsinhalt deutlich unter dem dokumentierten Budget, damit Nachrichtentext und MIME-Wrapping hineinpassen.
Kurzfassung
- Das Limit umfasst die kodierte Nachricht, den Text, die Header und die Anhänge.
- Base64 fügt der Größe einer Binärdatei etwa ein Drittel hinzu.
- Prüfen Sie jeden Anbieter im Zustellpfad.
- Ein Download-Link vermeidet Fehler durch Anhangsgrößenbeschränkungen bei großen Dateien.