PDF-Generierungs-API v1 – zustandslos

PDF-Generierungs-API
aus Geschäftsvorlagen

Generieren Sie PDFs aus Ihren HTML-, DOCX-, Markdown- oder JSON-Vorlagen. Keine Datenaufbewahrung – keine Speicherung von Dokumenten oder Daten.

Holen Sie sich Ihren API-Schlüssel Kurzanleitung

4 Eingabeformate

Variablensubstitution

Keine Datenspeicherung

99,9 % Verfügbarkeit SLA

Schnellstart

Erhalten Sie Ihr erstes PDF in weniger als 2 Minuten. Erstellen Sie einen API-Schlüssel, senden Sie eine Anfrage und laden Sie das Ergebnis herunter.

Holen Sie sich Ihren API-Schlüssel

Erstellen Sie einen API-Schlüssel über die Konsole unten oder über Ihr Dashboard.

Ihr API-Schlüssel ist ein Geheimnis. Machen Sie es niemals im Frontend-Code verfügbar.

Senden Sie Ihre erste Anfrage

Verwenden Sie den folgenden cURL-Befehl, um eine PDF-Datei zu generieren:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Laden Sie Ihr PDF herunter

Die API gibt die PDF-Binärdatei direkt im Antworttext zurück.

Das generierte PDF wird in der Datei gespeichert, die im Flag --output angegeben ist.

Live-Demo

Probieren Sie die API gleich hier aus – bearbeiten Sie den Inhalt und die Variablen und klicken Sie dann auf „Generieren“, um Ihr PDF sofort anzuzeigen.

Melden Sie sich an, um die Demo auszuprobieren

Erstellen Sie ein kostenloses Konto, um auf den Live-Playground zuzugreifen und bis zu 5 Demo-PDFs zu generieren.

Benutzerkonto erstellen anmelden

API-Konsole

Verwalten Sie Ihre API-Schlüssel und überwachen Sie die Nutzung direkt von dieser Seite aus.

Anmeldung erforderlich

Bitte melden Sie sich an, um Ihre API-Schlüssel zu erstellen und zu verwalten.

Benutzerkonto erstellen anmelden

Authentifizierung

Alle API-Anfragen erfordern einen API-Schlüssel, der über den X-API-Key-Header gesendet wird.

Wie es funktioniert

Erstellen Sie einen API-Schlüssel über die Konsole oder das Dashboard.
Fügen Sie es in jede Anfrage als X-API-Key-Header ein.
Die API validiert Ihren Schlüssel und überprüft Ihr Kontingent.
Ungültige oder widerrufene Schlüssel geben einen 401-Fehler zurück.

Bewahren Sie Ihren API-Schlüssel sicher auf. Verwenden Sie Umgebungsvariablen und kodieren Sie sie niemals fest im Quellcode.

Beispielanfrage

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Ungültige Schlüsselantwort (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Eingabeformate

EasyPDF unterstützt 4 Eingabeformate. Wählen Sie diejenige aus, die am besten zu Ihrem Arbeitsablauf passt.

HTML

Volle CSS-Unterstützung, pixelgenau über Chromium

DOCX

Laden Sie Word-Vorlagen mit variablen Platzhaltern hoch

Markdown

5 integrierte Designs für schöne Dokumente

Template JSON

Canvas-Engine für präzise Layoutsteuerung

HTML → PDF

Am beliebtesten

Senden Sie beliebigen HTML-Code mit Inline-CSS. Die Chromium-Rendering-Engine sorgt für eine pixelgenaue Ausgabe, die der Browseranzeige entspricht.

Hauptmerkmale

Volle CSS3-Unterstützung (Flexbox, Grid, Medienabfragen)
Benutzerdefinierte Kopf- und Fußzeilen mit Seitenzahlen
Variablenersetzung mit {{variable}}-Syntax
Responsive Layouts mit den Seitengrößen A4/Letter/Legal

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

API-Endpunkte

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Generieren Sie eine PDF-Datei aus HTML-, Markdown- oder JSON-Vorlageninhalten.

Request Body (JSON)

Parameter	Typ	Erforderlich	Beschreibung
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	HTML- oder Markdown-Inhaltszeichenfolge (erforderlich für html/markdown)
`template_data`	`object`	Yes*	Vorlagen-JSON-Objekt (erforderlich für Vorlagenformat)
`variables`	`object`	No	Schlüssel-Wert-Paare für die Variablensubstitution
`options`	`object`	No	PDF-Generierungsoptionen (Seitenformat, Ränder usw.)

Antwort

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Laden Sie eine DOCX-Datei zur Konvertierung in PDF mit optionaler Variablenersetzung hoch.

Form Fields

Field	Typ	Erforderlich	Beschreibung
`file`	File	Yes	Die zu konvertierende .docx-Datei
`variables`	string (JSON)	No	Schlüssel-Wert-Paare für die Variablensubstitution
`options`	string (JSON)	No	PDF-Optionen als JSON-String

POST/generate/previewAPI Key

Generieren Sie eine PNG-Vorschau der ersten Seite anstelle einer vollständigen PDF-Datei.

200Content-Type: image/png

GET/usageAPI Key

Überprüfen Sie Ihre aktuelle monatliche Nutzung und das verbleibende Kontingent.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Erstellen Sie einen neuen API-Schlüssel (erfordert JWT-Authentifizierung).

GET/keysJWT Bearer

Listen Sie alle Ihre API-Schlüssel mit Nutzungsstatistiken auf.

DELETE/keys/:key_idJWT Bearer

Einen API-Schlüssel dauerhaft widerrufen (deaktivieren).

Codebeispiele

Vollständige, gebrauchsfertige Beispiele in Ihrer bevorzugten Sprache und Ihrem bevorzugten Format. Wählen Sie unten eine Sprache und ein Eingabeformat aus.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Anwendungsfälle

Erfahren Sie, wie Teams die EasyPDF-API nutzen, um die Dokumentenerstellung im großen Maßstab zu automatisieren.

Rechnungen und Quittungen

Erstellen Sie Markenrechnungen mit dynamischen Einzelposten, Gesamtbeträgen und Kundendetails.

HTML / DOCX

Verträge und Vereinbarungen

Füllen Sie Word-Vorlagen mit Kundendaten und konvertieren Sie sie zum Signieren in PDF.

DOCX

Zertifikate und Diplome

Erstellen Sie personalisierte Zertifikate mit präzisem Layout und Positionierung.

Template JSON

Berichte und Dashboards

Verwandeln Sie Markdown- oder HTML-Daten in ausgefeilte PDF-Berichte.

Markdown / HTML

Briefe und Mailings

Generieren Sie personalisierte Briefe aus DOCX-Vorlagen für Massenmailings.

DOCX

Compliance-Dokumente

Erstellen Sie revisionssichere, manipulationssichere Compliance-Dokumente.

HTML

PDF-Optionen

Passen Sie die Ausgabe mit diesen optionalen Parametern im Optionsobjekt an.

Option	Typ	Standard	Beschreibung
`page_format`	`string`	`"A4"`	Seitengröße: A4, Letter, Legal, Tabloid oder benutzerdefiniert
`landscape`	`boolean`	`false`	Aktivieren Sie die Querformatausrichtung
`margin_top`	`string`	`"20mm"`	Oberer Rand (CSS-Einheiten: mm, cm, in, px)
`margin_bottom`	`string`	`"20mm"`	Unterer Rand
`margin_left`	`string`	`"15mm"`	Linker Rand
`margin_right`	`string`	`"15mm"`	Rechter Rand
`header_html`	`string`	`null`	HTML-Inhalt für den Seitenkopf
`footer_html`	`string`	`null`	HTML-Inhalt für den Seitenfuß (unterstützt pageNumber, totalPages)
`theme`	`string`	`"modern"`	Markdown-Theme: modern, klassisch, minimalistisch, Github, akademisch

Beispiel für vollständige Optionen

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Fehlerbehandlung

Die API gibt strukturierte JSON-Fehler mit konsistenten Fehlercodes zurück.

Fehlerantwortformat

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Wann	Was zu tun
`400`	`missing_content`	Erforderliches Feld fehlt	Überprüfen Sie die Felder des Anforderungstexts
`400`	`invalid_json`	Die JSON-Analyse ist fehlgeschlagen	Validieren Sie Ihre JSON-Nutzlast
`400`	`unsupported_format`	Unbekannter Formatwert	Verwenden Sie HTML, Markdown oder Vorlage
`401`	`invalid_api_key`	API-Schlüssel nicht gefunden	Überprüfen Sie Ihren X-API-Key-Header
`402`	`quota_exceeded`	Monatliches Kontingent überschritten	Aktualisieren Sie Ihren Plan oder warten Sie auf die Zurücksetzung
`403`	`api_key_revoked`	Der Schlüssel wurde widerrufen	Erstellen Sie einen neuen API-Schlüssel
`429`	`rate_limit_exceeded`	Ratenlimit erreicht	Warten Sie und versuchen Sie es erneut mit exponentiellem Backoff
`500`	`generation_failed`	Interner Verarbeitungsfehler	Überprüfen Sie Ihren Inhalt auf Fehler und versuchen Sie es erneut

Ratenlimits und Kontingente

Jeder Plan hat ein monatliches PDF-Kontingent und eine Ratenbegrenzung pro Minute.

Ratenbegrenzung

Anfragen, die Ihr Ratenlimit überschreiten, erhalten eine 429-Antwort mit einem Retry-After-Header.

Begrenzte Reaktion

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Monatliche Kontingente

Die Nutzung wird am 1. jedes Monats um Mitternacht UTC zurückgesetzt.

Plan	PDFs/Monat	Rate limit	Preis	Überschuss
Starter	500	10/min	9€/Monat	0,02€/PDF
Business	5 000	30/min	79€/Monat	0,01€/PDF
Enterprise	Brauch	Brauch	Auf Zitat	Verhandelbar

Best Practices

Befolgen Sie diese Empfehlungen, um die API optimal zu nutzen.

Verwenden Sie Variablen für dynamische Inhalte

Halten Sie Ihre Vorlagen statisch und fügen Sie Daten über das Variablenobjekt ein. Dies ist effizienter, als HTML bei jedem Aufruf neu zu erstellen.

Gehen Sie mit Fehlern elegant um

Überprüfen Sie immer den HTTP-Statuscode. Implementieren Sie Wiederholungsversuche mit exponentiellem Backoff für 429- und 5xx-Fehler.

Optimieren Sie Ihre Vorlagen

Minimieren Sie CSS, vermeiden Sie externe Assets (inline) und testen Sie Vorlagen, bevor Sie sie in der Produktion bereitstellen.

Überwachen Sie Ihre Nutzung

Verwenden Sie den Endpunkt /usage oder die Konsole oben, um den Verbrauch zu verfolgen und unerwartete Kontingentgrenzen zu vermeiden.

Sichern Sie Ihre API-Schlüssel

Speichern Sie Schlüssel in Umgebungsvariablen oder Secret-Managern. Tauschen Sie die Schlüssel regelmäßig aus und entziehen Sie nicht verwendete Schlüssel.

Preise

Einfache, transparente Preisgestaltung. Zahlen Sie nur für das, was Sie nutzen.

Starter

9€/Monat

~0,018€ / PDF

500 PDFs / Monat
10 Anfragen/Min
Alle 4 Eingabeformate
PNG-Vorschaugenerierung
E-Mail-Support
Überschuss : 0,02€/PDF

Legen Sie los

Bestes Preis-Leistungs-Verhältnis

Business

79€/Monat

~0,016€ / PDF

5 000 PDFs / Monat
30 Anfragen/Min
Alle Starter-Funktionen
Vorrangiger Support
Dashboard zur Nutzungsanalyse
Überschuss : 0,01€/PDF