PDFs ohne Bibliotheken verwalten: API für Merge, Split und Wasserzeichen

Du musst regelmäßig PDF-Dokumente zusammenführen, mit Wasserzeichen versehen oder eine Reihe von Bildern in eine einzige Datei umwandeln? Bisher waren dafür Tools wie pdf-lib, pdftk oder ghostscript nötig – doch deren Installation scheitert oft an fehlenden Berechtigungen auf dem Server oder führt zu stundenlangem Debugging.

Eine einfachere Lösung bietet eine leichtgewichtige HTTP-API, die häufige PDF-Aufgaben direkt über das Netzwerk erledigt. Du lädst einfach eine Datei hoch und erhältst das gewünschte Ergebnis zurück – ohne lokale Bibliotheken, ohne Build-Schritte und unabhängig von der verwendeten Programmiersprache. Im Folgenden zeigen wir dir, wie du mit cURL und Node.js Dokumente zusammenführst, Wasserzeichen hinzufügst oder Bilder in PDFs umwandelst.

Die verfügbaren Endpunkte der API

Die PDF Toolkit API stellt insgesamt sechs Endpunkte bereit, die gängige Operationen abdecken:

• POST /v1/pdf/merge – Mehrere PDFs zu einem Dokument kombinieren
• POST /v1/pdf/split – Ein PDF in einzelne Seiten oder Seitenbereiche aufteilen
• POST /v1/pdf/rotate – Seiten im Dokument drehen
• POST /v1/pdf/watermark – Auf jeder Seite einen Textstempel anbringen
• POST /v1/pdf/info – Informationen wie Seitenzahl oder Dateigröße abrufen
• POST /v1/images-to-pdf – Mehrere Bilder (JPG, PNG) in eine PDF-Datei umwandeln

Die API ist über RapidAPI nutzbar. Dort kannst du dich kostenlos im BASIC-Plan registrieren und erhältst eine API-Schlüssel. Dieser Schlüssel wird im Header X-RapidAPI-Key mit jeder Anfrage übermittelt.

PDFs zusammenführen mit cURL

Um zwei PDF-Dokumente zu einem einzigen Dokument zu kombinieren, kannst du folgenden Befehl verwenden:

curl -X POST \
 ' \
 -H 'X-RapidAPI-Key: DEIN_API_SCHLÜSSEL' \
 -H 'X-RapidAPI-Host: pdf-toolkit-api2.p.rapidapi.com' \
 -F 'files=@dokument1.pdf' \
 -F 'files=@dokument2.pdf' \
 --output zusammengefuegt.pdf

Die Dateien dokument1.pdf und dokument2.pdf werden in der Reihenfolge ihrer Übermittlung zu einer neuen Datei namens zusammengefuegt.pdf kombiniert.

PDFs in Node.js zusammenführen

In einer JavaScript-Umgebung kannst du die API mit einer Bibliothek wie axios nutzen. Hier ein vollständiges Beispiel:

import fs from 'node:fs';
import FormData from 'form-data';
import axios from 'axios';

const form = new FormData();
form.append('files', fs.createReadStream('dokument1.pdf'));
form.append('files', fs.createReadStream('dokument2.pdf'));

const response = await axios.post(
  '
  form,
  {
    responseType: 'arraybuffer',
    headers: {
      ...form.getHeaders(),
      'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
      'X-RapidAPI-Host': 'pdf-toolkit-api2.p.rapidapi.com',
    },
  }
);

fs.writeFileSync('zusammengefuegt.pdf', response.data);
console.log('PDF wurde erfolgreich kombiniert.');

Wasserzeichen auf PDF-Seiten anbringen

Eine häufige Anforderung ist das Hinzufügen von Wasserzeichen wie "ENTWURF", "BEZAHLT" oder einem Kundenamen auf jeder Seite eines PDFs. Mit dem Endpunkt POST /v1/pdf/watermark gelingt dies in wenigen Schritten:

curl -X POST \
 ' \
 -H 'X-RapidAPI-Key: DEIN_API_SCHLÜSSEL' \
 -H 'X-RapidAPI-Host: pdf-toolkit-api2.p.rapidapi.com' \
 -F 'file=@bericht.pdf' \
 -F 'text=ENTWURF' \
 --output mit_wasserzeichen.pdf

Bilder in ein PDF umwandeln

Scans, Screenshots oder eine Sammlung von Fotos lassen sich schnell in ein durchsuchbares PDF konvertieren:

curl -X POST \
 ' \
 -H 'X-RapidAPI-Key: DEIN_API_SCHLÜSSEL' \
 -H 'X-RapidAPI-Host: pdf-toolkit-api2.p.rapidapi.com' \
 -F 'files=@scan1.jpg' \
 -F 'files=@scan2.png' \
 --output gesamt.pdf

Warum eine API statt einer lokalen Bibliothek?

Natürlich gibt es Szenarien, in denen eine lokale Bibliothek wie pdf-lib die bessere Wahl ist – insbesondere, wenn du nur eine einzige PDF-Operation durchführst und bereits mit der Bibliothek vertraut bist. Die API überzeugt vor allem in diesen Situationen:

• Serverlose Umgebungen oder eingeschränkte Hosts: Viele Cloud-Dienste erlauben keine Installation nativen Codes oder erfordern komplexe Build-Prozesse.
• Umfangreiche Anforderungen: Wenn du mehrere Funktionen wie Merge, Split und Rotate benötigst, ist eine API praktischer als die Pflege mehrerer Bibliotheken.
• Kein Wunsch nach Wartung: Warum selbst PDF-Logik schreiben oder aktualisieren, wenn eine API die Arbeit übernimmt?

Hinzu kommt der wirtschaftliche Aspekt: Die kostenlose Testversion umfasst 100 Anfragen pro Tag. Für höhere Volumina sind die Kosten deutlich niedriger als die Zeit, die du mit der Fehlersuche in Tools wie ghostscript verbringen würdest.

Fazit: Einfache PDF-Verarbeitung für moderne Anwendungen

Die PDF Toolkit API bietet eine unkomplizierte Möglichkeit, häufige PDF-Aufgaben ohne lokale Abhängigkeiten zu lösen. Ob auf einem Server, in einer serverlosen Funktion oder in einer Desktop-Anwendung – die API ermöglicht eine schnelle Integration und spart wertvolle Entwicklungszeit. Für Entwickler, die zusätzlich Bildbearbeitung benötigen, steht mit dem Image Toolkit API ein passender Begleiter zur Verfügung.

Falls du auf Herausforderungen stößt oder spezielle Funktionen vermisst, lohnt sich ein Blick in die Kommentare des API-Anbieters. Dort werden häufig Lösungen oder Erweiterungen vorgeschlagen.