PDFVela — pdfvela.com
Alle PDF-Werkzeuge

PDF als Base64 an eine API senden

Eine API für E-Rechnungen, elektronische Unterschriften oder den Versand will das Dokument in einem JSON-Feld haben. So machst du aus dem PDF den richtigen Text, prüfst ihn und vermeidest die Fehler, an denen der Request scheitert.

Von · Aktualisiert am 10. November 2026

Was die API normalerweise erwartet

Die meisten Dokument-APIs beschreiben einen JSON-Body mit einem Feld namens content, file, data oder document. Sein Wert ist der Base64-Code des PDFs, oft zusammen mit einem Dateinamen und einem Typ:

{
  "fileName": "invoice-1024.pdf",
  "mimeType": "application/pdf",
  "content": "JVBERi0xLjcKJ..."
}

Bevor du Code schreibst, such in der Dokumentation nach drei Dingen: dem Feldnamen, ob ein data:-Präfix gewünscht ist (meist nicht) und der Größengrenze.

1. Das PDF in Base64 umwandeln

Am schnellsten kommst du mit PDF in Base64 an einen Testwert. Wähle das PDF aus, entscheide dich für Nur Base64-Code und kopiere das Ergebnis. Brauchst du als Ausgangspunkt einen kompletten Request-Body, wähle stattdessen JSON – dann kommen Dateiname und Typ automatisch dazu. Das PDF wird in deinem Browser umgewandelt und nicht hochgeladen. Das ist wichtig, wenn dein Testdokument eine echte Rechnung ist.

Prüfe das Ergebnis: Es sollte mit JVBERi0 beginnen, keine Leerzeichen enthalten und – abgesehen von ein oder zwei =-Zeichen am Ende – nur aus Buchstaben, Ziffern, + und / bestehen.

2. Aus deinem Code senden

Derselbe Schritt in drei verbreiteten Sprachen. Jedes Beispiel liest die Datei, kodiert sie und schickt das JSON per POST:

# curl (Linux / macOS): base64 -w 0 hält alles in einer Zeile
curl -X POST https://api.example.com/documents \
  -H "Content-Type: application/json" \
  -d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 mit requests
import base64, requests
with open("invoice.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
              json={"fileName": "invoice.pdf", "content": content})

Unter macOS verwendet die curl-Zeile base64 -i invoice.pdf statt -w 0. Adresse und Feldnamen sind nur Beispiele – nimm die aus der Dokumentation deines Dienstes.

3. Den Rückweg prüfen

Liefert der Dienst das Dokument oder eine gespeicherte Kopie als Base64 zurück, füge diese Antwort in Base64 in PDF ein. Siehst du die erste Seite und die richtige Seitenanzahl, ist das der schnellste Beweis, dass unterwegs nichts verloren gegangen ist. Die einzelnen Schritte für diese Richtung findest du in der Anleitung Base64-String als PDF-Datei speichern.

Häufige Fehler

SymptomWahrscheinliche UrsacheLösung
„Invalid Base64“Zeilenumbrüche (Zeilen mit 76 Zeichen) oder ein data:-PräfixDen reinen Code in einer Zeile senden
„Payload too large“ (413)Das PDF ist nach dem Kodieren zu großMit PDF komprimieren verkleinern
Das PDF öffnet sich leer oder beschädigtDer String wurde abgeschnittenNeu kodieren und den vollständigen Wert senden
Umlaute im Namen werden falsch angezeigtDateiname in der falschen Zeichenkodierung gesendetDen JSON-Body in UTF-8 halten

Lust, es auszuprobieren? Es ist kostenlos und deine Datei bleibt auf deinem Gerät.

PDF in Base64 öffnen

Fragen zum Senden eines PDFs als Base64

Warum wollen APIs Base64 statt der Datei?

JSON kann nur Text transportieren. Base64 schreibt die Bytes des PDFs mit Buchstaben, Ziffern, + und / – so passt das ganze Dokument in ein einziges Textfeld neben die übrigen Daten, etwa die Kundennummer oder das Rechnungsdatum.

Soll ich das Präfix data:application/pdf;base64, mitschicken?

Meistens nicht. Die meisten APIs erwarten nur den Code, der mit JVBERi0 beginnt. Schick die Data-URI nur, wenn die Dokumentation sie zeigt oder ein Browser eine URL braucht, zum Beispiel in einem iframe.

Die API meldet ungültiges Base64. Was ist die häufigste Ursache?

Zeilenumbrüche oder ein Präfix im String – oder ein Code, der beim Einfügen abgeschnitten wurde. Verwende den reinen Code in einer einzigen Zeile und prüfe, ob das Ende des Strings vollständig angekommen ist.

Wie groß darf das PDF sein?

Das hängt vom Dienst ab. Der Text ist aber etwa ein Drittel größer als die Datei, aus einem 3-MB-PDF werden also rund 4 MB JSON. Viele APIs steigen schon bei wenigen Megabyte aus – das PDF vorher zu komprimieren ist die einfachste Lösung.

Ist Base64 eine Art Verschlüsselung?

Nein. Wer den Code hat, kann ihn wieder in das Dokument zurückverwandeln. Schick ihn nur über HTTPS und füge ein vertrauliches PDF nie in eine Website ein, die es hochlädt.