PDF-API: Dokumente aus Ihren Daten erstellen, ohne eigenen Browser

01Was eine PDF-API macht

Die meisten Unternehmen verschicken immer wieder dieselben Dokumente: Rechnungen, Lieferscheine, Angebote, Zertifikate, Berichte und Verträge. Das Layout bleibt gleich, nur die Angaben ändern sich. Eine PDF-API speichert das Layout als Vorlage und füllt die Angaben bei jeder Anfrage neu.

Vorlage plus Daten gleich PDF. Sie gestalten das Dokument einmal in HTML und CSS, also mit demselben Code wie eine Webseite. Jede Anfrage sendet nur das, was sich ändert: einen Kundennamen, eine Liste von Positionen oder einen Kurstitel. Die API füllt die Vorlage, verteilt den Inhalt auf Seiten und gibt eine PDF-Datei oder einen privaten Download-Link zurück.

Sie brauchen keine PDF-Bibliothek, keinen Headless-Browser auf Ihren Servern und keinen Layout-Code in Ihrer Anwendung. Ihre Anwendung kümmert sich um Daten. Die API kümmert sich um das Papier.

02Zwei Wege zum PDF

HTML senden. Gut für einzelne Dokumente oder wenn Ihre Anwendung das HTML ohnehin baut. Mit einem zusätzlichen data-Objekt behandelt die API das HTML zuerst als Vorlage. Mehr dazu auf der Seite zur HTML-zu-PDF-API.

curl https://api.castpdf.com/v1/pdf \
  -H "Authorization: Bearer $CASTPDF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hallo {{ name }}</h1>", "data": {"name": "Ada"}}' \
  --output hallo.pdf

Vorlage speichern, JSON senden. Gut für Dokumente, die täglich entstehen. Das Design liegt in CastPDF, mit Live-Vorschau und Versionsverlauf. So kann eine Designerin es ändern, ohne dass Sie neu deployen. Ihr Code sendet nur die ID der Vorlage und die Daten.

const res = await fetch('https://api.castpdf.com/v1/pdf', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CASTPDF_API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    template_id: process.env.LIEFERSCHEIN_TEMPLATE_ID,
    data: { customer: { name: 'Werkstatt Kranich GmbH' }, items: [{ description: 'Montageplatte', quantity: 12 }] },
    response: 'url',
  }),
});
const { url } = await res.json();

<?php
$ch = curl_init('https://api.castpdf.com/v1/pdf');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CASTPDF_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'template_id' => getenv('LIEFERSCHEIN_TEMPLATE_ID'),
        'data' => ['customer' => ['name' => 'Werkstatt Kranich GmbH']],
    ]),
]);
file_put_contents('lieferschein.pdf', curl_exec($ch));

Beide Wege nutzen denselben Endpunkt, POST /v1/pdf. Der Quickstart dauert etwa fünf Minuten. Der Leitfaden PDF aus JSON erstellen erklärt den Weg über Vorlagen Schritt für Schritt.

03Selbst bauen oder eine API nutzen?

PDFs lassen sich auch ohne API erzeugen. Viele Teams fangen so an, und manche sollten dabei bleiben. So schneiden die üblichen Wege ab:

Wann Sie keine API brauchen. Erzeugen Sie jede Nacht Millionen einfacher PDFs, ist ein eigener Server günstiger. Dürfen Ihre Dokumente Ihr Netz nie verlassen, hosten Sie selbst. Alle anderen sparen meist Wochen. Wer Chrome selbst betreibt, kämpft oft mit Speicherlecks, leeren Seiten und fehlenden Schriften. Unser Vergleich CastPDF und Puppeteer wägt das ehrlich ab.

04Was über die Druckqualität entscheidet

Ein PDF, das auf Seite eins gut aussieht, kann auf Seite zwei auseinanderfallen. Diese Details unterscheiden ein brauchbares Dokument von einer Supportanfrage:

• Seitenumbrüche, die funktionieren. Tabellenzeilen bleiben ganz, und ein Summenblock bleibt auf einer Seite. Mehr im Leitfaden zu Seitenumbrüchen.
• Wiederholte Tabellenköpfe. Läuft eine Rechnung auf Seite zwei weiter, wandern die Spaltennamen mit. Siehe Tabellenkopf wiederholen.
• Seitenzahlen. „Seite 2 von 5“ in der Fußzeile, aber nicht auf dem Deckblatt. Siehe Seitenzahlen in HTML zu PDF.
• Schriften, die laden. Die Schrift der Vorschau ist die Schrift im PDF. Noto ist für viele Schriftsysteme installiert, Umlaute inklusive.
• Kein stiller Verlust. Würde Inhalt abgeschnitten, schlägt die Anfrage mit einer klaren Fehlermeldung fehl, statt ein kaputtes PDF zu liefern.

Vorlagen werden standardmäßig im Druckmodus gerendert. Dieser Modus setzt die Seiten mit Paged.js, bevor Chromium sie druckt. So funktionieren laufende Kopfzeilen und Seitenzähler.

05Dokumente, die Unternehmen automatisch erstellen

Jede Dokumentart hat eigene Regeln. Rechnungen brauchen korrekte Summen und Steuern, Lieferscheine kommen ohne Preise aus, Zertifikate entstehen einzeln pro Person. Starten Sie mit der Vorlage, die Ihrem Dokument am nächsten kommt:

• Lieferschein: Lieferadresse, Waren mit Mengen und eine Empfangsbestätigung, ohne Preise.
• Kostenvoranschlag: Positionen, Gültigkeit und ein Feld für die Annahme durch den Kunden.
• Rechnung und Quittung: mit Umsatzsteuer und Summen, die die Vorlage selbst berechnet.
• E-Rechnungen im Format ZUGFeRD oder XRechnung, für die Pflicht ab 2027.
• Zertifikate, Berichte und Tickets finden Sie in der englischen Vorlagengalerie.

Alle deutschen Vorlagen stehen in der Übersicht der PDF-Vorlagen, jede mit ihren echten Beispieldaten.

06HTML in PDF umwandeln

Viele suchen zunächst nur einen Weg, eine HTML-Seite als PDF zu speichern. Für einzelne Dateien reicht unser kostenloser HTML-zu-PDF-Konverter im Browser. Er nutzt dieselbe Technik wie die API, ganz ohne Konto.

Sobald das täglich passiert, ist die API der bessere Weg. Ihr System sendet das HTML, und das PDF kommt zurück, ohne dass jemand eine Datei hochlädt. Bilder und Schriften lädt der Renderer von öffentlichen Adressen.

07Aus Ihrer Programmiersprache

Jede Sprache, die eine HTTPS-Anfrage senden kann, kann die API aufrufen. Sie installieren nichts. Für viele Sprachen gibt es eine Entwicklerseite mit lauffähigem Code und einer Checkliste für den Betrieb: PHP, Python, Java, C# und .NET, Node.js und Laravel.

Sie arbeiten ohne Code? Für n8n gibt es einen CastPDF-Community-Node auf npm. Viele andere Werkzeuge haben einen allgemeinen HTTP-Schritt, mit dem sie CastPDF schon heute aufrufen können. Fertige Apps für weitere Werkzeuge gibt es noch nicht.

08Preise pro PDF, nie pro Seite

Ein fertiges Dokument zählt als ein PDF, ob es 1 Seite hat oder 50. Test-PDFs sind in jedem Tarif kostenlos und unbegrenzt, und fehlgeschlagene Anfragen zählen nie.

Bei jährlicher Zahlung kostet Starter 15 $ im Monat. In bezahlten Tarifen gehen ungenutzte PDFs einen Monat in den nächsten über. Sie können über Ihren Tarif hinaus erzeugen, bis zu einer Ausgabengrenze, die Sie selbst festlegen. Bei 80 und 100 Prozent Ihrer PDFs erhalten Sie eine E-Mail. Alle Details stehen auf der Preisseite.

09Daten, Datenschutz und Hosting in der EU

Ihre PDFs werden auf Servern in Deutschland erstellt und gespeichert. Ein Auftragsverarbeitungsvertrag ist Teil unserer Bedingungen, Sie müssen also nichts extra unterschreiben. Gespeicherte PDFs werden gelöscht, wenn die Speicherzeit Ihres Tarifs endet: von 1 Tag im kostenlosen Tarif bis 90 Tage im Tarif Scale.

Der Renderer lädt Bilder und Schriften nur von öffentlichen Internetadressen, nie aus privaten Netzen. Jedes Dokument hat eigene Grenzen: 30 Sekunden und 50 Seiten. Wir nutzen Ihre Dokumente nicht, um Modelle zu trainieren.

Zum Vergleich der Kosten: Bei 10.000 PDFs im Monat kostet CastPDF 49 $, bei 50.000 PDFs 129 $. Unsere Vergleiche mit anderen Anbietern nutzen öffentliche Preise mit Quelle, zum Beispiel die besten PDF-APIs im Überblick.

10Häufige Fragen

11Alles zum Thema PDF-API

Alle Seiten, die auf dieser aufbauen. Jede beantwortet eine engere Frage ausführlicher.