Skip to main content

PDF Tools API

HTML zu PDF API

Bauen Sie HTML in PDF umwandeln in Backend, Stapelverarbeitung oder Produktabläufe ein, ohne eigene PDF-Infrastruktur zu betreiben.

Create API KeyRead full API docs

Credits

1 Credit / call

1 Credit per successful API request. Failed processing attempts are refunded automatically.

Pricing

1,000 Credits = $1

Every signed-in user receives 100 free API Credits each month.

Endpoint

/api/external/html-to-pdf/pdf

Use your API Key in the x-api-key header.

Use case

Geeignet für Berichte, Quittungen, Auszüge oder interne Ansichten serverseitig zu rendern. Das Web-Tool passt zur manuellen Prüfung, die API zu wiederholbarer serverseitig ausgeführter Automatisierung.

cURL example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'html=@index.html;type=text/html' \
  -F 'pageSize=A4' \
  -F 'printBackground=true' \
  --output html-to-pdf.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'html=@index.html;type=text/html' \
  -F 'pageSize=A4' \
  -F 'printBackground=true' \
  --output html-to-pdf.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/html-to-pdf/pdf \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "html": "<!doctype html><html><body><h1>Report</h1></body></html>",
    "pageSize": "A4",
    "printBackground": true
  }' \
  --output html-to-pdf.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/html-to-pdf/pdf', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  html: '<!doctype html><html><body><h1>Report</h1></body></html>',
  pageSize: 'A4',
  printBackground: true
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('html-to-pdf.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/html-to-pdf/pdf',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'html': '<!doctype html><html><body><h1>Report</h1></body></html>',
        'pageSize': 'A4',
        'printBackground': True,
    },
)
response.raise_for_status()

with open('html-to-pdf.pdf', 'wb') as f:
    f.write(response.content)

Error codes

400invalid_payload

JSON oder multipart enthält nicht die erforderliche HTML-, URL- oder Dateieingabe.

401invalid_api_key

Der x-api-key fehlt, ist ungültig oder wurde rotiert.

402insufficient_credits

Das Konto hat nicht genug API Credits.

502conversion_failed

Das serverseitige Rendering konnte die Konvertierung nicht abschließen. Credits werden bei Fehlschlag automatisch erstattet.

Limits

  • Benötigt ein gültiges PDF oder gültige Eingabedaten.
  • Rufen Sie die API serverseitig auf, damit der API Key nicht im Browser erscheint.
  • Testen Sie repräsentative Dateien vor großen Stapeln.

Response headers

html-to-pdf.pdf mit Response-Headern für verbrauchte Credits und verbleibendes Guthaben.

Content-Type
MIME-Typ der erzeugten Datei, meistens application/pdf oder application/zip.
Content-Disposition
Dateiname für den Download der Ausgabe.
X-Credits-Charged
Credits, die für die erfolgreiche Anfrage berechnet wurden.
X-Credit-Balance
Verbleibendes API-Credits-Guthaben nach der Anfrage.

FAQ

Was kostet die HTML zu PDF API?

Erfolgreiche Anfragen nutzen API Credits; fehlgeschlagene Verarbeitung wird automatisch erstattet. Angemeldete Nutzer erhalten monatlich 100 free API Credits, 1,000 Credits = $1.

Nutzen Web-Tools API Credits?

Nein. Browserlokale Web-Tools verbrauchen keine API Credits. Nur Anfragen mit API Key werden berechnet.

Kann ich die API aus dem Browser aufrufen?

Das sollten Sie nicht tun. Speichern Sie den API Key im Backend, in Queues oder serverseitigen Jobs.

Start with 100 free API Credits

Create an API Key, test HTML zu PDF API, and buy more Credits only when automation volume grows.

Get API KeyView full API docs