PDF-zu-Base64-Konverter

PDFs über JSON-APIs senden

JSON kennt keinen Binärtyp, daher nehmen REST-APIs, die Dokumente empfangen, diese meist als Base64-String entgegen. Plattformen für elektronische Signaturen, Rechnungs- und E-Rechnungssysteme, Druck- und Versanddienste, OCR-Engines und Dokumentenarchive akzeptieren PDFs häufig auf diese Weise, in einem Feld wie content, file oder documentBase64, mit dem Dateinamen in einem separaten Feld. Manche Dienste liefern PDFs auf demselben Weg zurück. Mit Base64 zu PDF machen Sie daraus wieder Dateien.

Senden Sie reines Base64 ohne Zeilenumbrüche, sofern die API-Dokumentation nichts anderes vorschreibt, denn viele APIs lehnen einen Wert ab, der noch das Präfix data:application/pdf;base64, enthält. Denken Sie auch an Größenlimits für Anfragen: Aus einem 7,5-MB-PDF werden etwa 10 MB Base64.

Ein Base64-PDF erkennen

Eine PDF-Datei beginnt mit den Zeichen %PDF-, gefolgt von der Versionsnummer. Als Base64 kodiert ergeben diese Bytes immer einen String, der mit JVBERi0 beginnt. Ein langer String, der in einer API-Antwort, einer Datenbankspalte oder einer Logdatei mit JVBER anfängt, ist fast sicher ein PDF. Dieselbe Prüfung hilft auch, bevor Sie Nutzdaten senden: Beginnt Ihr String mit etwas anderem, haben Sie möglicherweise die falschen Daten kodiert oder sie doppelt kodiert.

Ein PDF in HTML einbetten

Eine Data-URI bettet das gesamte PDF in eine HTML-Seite ein, ohne dass eine separate Datei gehostet werden muss:

<embed src="data:application/pdf;base64,JVBERi0..." type="application/pdf" width="100%" height="600">

<iframe src="data:application/pdf;base64,JVBERi0..." width="100%" height="600"></iframe>

Das funktioniert in Desktop-Browsern mit integriertem PDF-Viewer, hat aber Grenzen. Viele mobile Browser zeigen PDFs innerhalb einer Seite überhaupt nicht an. Chrome und einige andere Browser verhindern außerdem, dass eine Seite den gesamten Tab zu einer data:-URL navigiert. Ein Link oder ein window.open-Aufruf, der auf eine data:application/pdf-URI zeigt, öffnet daher womöglich einen leeren Tab oder bewirkt gar nichts. Um ein PDF per JavaScript in einem neuen Tab zu öffnen, wandeln Sie das Base64 stattdessen in eine Blob-URL um. Für Dokumente, die größer als ein paar Megabyte sind, ist eine normale Datei-URL meist die bessere Wahl.

Ein PDF im Code kodieren

# Python: JSON-Request-Body erstellen
import base64, json
from pathlib import Path

pdf_b64 = base64.b64encode(Path('invoice.pdf').read_bytes()).decode('ascii')
body = json.dumps({'filename': 'invoice.pdf', 'content': pdf_b64})

// Browser: file stammt aus einem <input type="file">
const reader = new FileReader();
reader.onload = () => {
  const pdfBase64 = reader.result.split(',')[1]; // Data-URI-Präfix entfernen
};
reader.readAsDataURL(file);