Wann brauchst du ein PDF als Base64?
JSON, XML und viele Formulare können nur Text transportieren. Eine Binärdatei wie ein PDF muss deshalb zuerst als Text geschrieben werden – und Base64 ist dafür der übliche Weg:
- Ein Dokument an eine API senden. Dienste für E-Rechnungen, elektronische Unterschriften, Versand und Dokumentenverwaltung verlangen das PDF oft in einem Feld namens content, file oder data.
- Die eigene Integration testen. Mit der JSON-Variante erhältst du einen fertigen Request-Body zum Einfügen in Postman, curl oder einen Unit-Test – ganz ohne eigenen Kodierungscode.
- In einer Textspalte oder Konfiguration speichern. Manche Systeme legen kleine Vorlagen oder Zertifikate als Text ab; mit Base64 passt auch ein PDF hinein.
- In eine Webseite einbetten. Mit einer Data-URI zeigt eine Seite ein PDF in einem iframe an, ohne eine separate Datei zu hosten – gut geeignet für kleine Dokumente.
Schritt-für-Schritt-Beispiele für Anfragen mit curl, JavaScript und Python findest du unter So sendest du ein PDF als Base64 an eine API. Um den Code wieder in eine Datei zu verwandeln, nutze Base64 in PDF; für Bilder gibt es Bild in Base64.
So sehen die Formate aus
| Format | Beginnt mit | Typische Verwendung |
|---|---|---|
| Nur Base64-Code | JVBERi0 | API-Felder, JSON, XML, Datenbanken |
| Data-URI | data:application/pdf;base64, | Browser-Tab, iframe, object-Tag |
| Zeilen mit 76 Zeichen | JVBERi0, in kurze Zeilen umbrochen | E-Mail-Anhänge (MIME), Dateien im PEM-Stil |
| JSON | { "fileName": … } | Request-Body zum Testen einer Integration |
Wenn etwas nicht klappt
„Diese Datei konnte nicht als PDF geöffnet werden.“ Die Datei beginnt nicht mit der Signatur %PDF- – vielleicht ist es eine Word-Datei oder ein Bild, das in .pdf umbenannt wurde. Öffne sie zuerst in einem PDF-Reader oder wandle sie mit dem passenden Werkzeug um.
Die API meldet, der Inhalt sei ungültig. Prüfe, ob du den reinen Code ohne das Präfix data: und ohne Zeilenumbrüche gesendet hast – es sei denn, die Dokumentation verlangt sie. Achte außerdem darauf, dass beim Einfügen am Ende nichts abgeschnitten wurde.
Der Text ist zu lang für das Feld. Verkleinere das PDF mit PDF komprimieren und wandle es erneut um; der Code schrumpft im selben Verhältnis.