Skip to main content

PDF Tools API

PDF Kopf- und Fußzeile API

Bauen Sie Kopf- und Fußzeilen hinzufügen 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/pdf-tools/header-footer

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

Use case

Geeignet für Berichte, Kontodokumente und interne Ausgaben mit Datum oder Referenz zu versehen. 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/pdf-tools/header-footer \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}' \
  --output header-footer.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/header-footer \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}' \
  --output header-footer.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/header-footer \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}
  }' \
  --output header-footer.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/header-footer', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': process.env.ITEXTMASTER_API_KEY
  },
  body: JSON.stringify({
  file: { name: 'input.pdf', dataBase64: 'JVBERi0xLjcK...' },
  options: {"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}
})
});

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

await writeFile('header-footer.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/header-footer',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'headerText': 'Quarterly Report', 'footerText': 'Page {page} of {total}'}
    },
)
response.raise_for_status()

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

Error codes

401invalid_api_key

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

402insufficient_credits

Das Konto hat nicht genug API Credits.

422pdf_tool_processing_failed

Datei, Optionen oder PDF-Struktur konnten nicht verarbeitet werden. 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

header-footer.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 PDF Kopf- und Fußzeile 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 PDF Kopf- und Fußzeile API, and buy more Credits only when automation volume grows.

Get API KeyView full API docs