PDF-API
Kostenlos starten

Macaaw PDF-API

PDF-API zum Komprimieren, Konvertieren und Signieren

Eine REST-API für 20 PDF-Tools und E-Signaturen. Jede Aufgabe läuft auf unseren Servern in London, und die Dateien werden innerhalb von 2 Stunden gelöscht.

Kostenlosen Sandbox-Schlüssel holenAPI-Dokumentation lesen

  • OpenAPI 3.1
  • Postman-Collection
  • Kostenlose Sandbox
  • Signierte Webhooks
Eine PDF mit einer Anfrage komprimieren
Sprache des Codebeispiels
curl https://macaaw.com/public/v1/tasks \
  -H "Authorization: API-Key $MACAAW_API_KEY" \
  -F "files[]=@lease.pdf" \
  -F 'data={"tool":"compress-pdf","options":{"level":"recommended"}}'

# 201 Created
{ "id": "…", "tool": "compress-pdf", "status": "task.queued" }
// Node 18+ (fetch, FormData and Blob are built in)
import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("files[]", new Blob([await readFile("lease.pdf")]), "lease.pdf");
form.append("data", JSON.stringify({ tool: "compress-pdf", options: { level: "recommended" } }));

const res = await fetch("https://macaaw.com/public/v1/tasks", {
  method: "POST",
  headers: { Authorization: `API-Key ${process.env.MACAAW_API_KEY}` },
  body: form,
});
const task = await res.json(); // { id, tool, status: "task.queued" }
# Python 3 with requests
import json, os, requests

res = requests.post(
    "https://macaaw.com/public/v1/tasks",
    headers={"Authorization": f"API-Key {os.environ['MACAAW_API_KEY']}"},
    files={"files[]": open("lease.pdf", "rb")},
    data={"data": json.dumps({"tool": "compress-pdf", "options": {"level": "recommended"}})},
)
task = res.json()  # {"id": ..., "status": "task.queued"}
  • 20PDF-Tools an einem Endpunkt
  • 1 Aufrufzum Hochladen und Starten einer Aufgabe
  • < 2 hbis Ihre Dateien gelöscht werden
  • 0 £für die Sandbox

Was Sie bauen können

Die PDF-Aufgaben, die Ihr Produkt nicht selbst übernehmen sollte

  • Uploads verkleinern, bevor Sie sie speichern

    Komprimieren Sie PDFs oder passen Sie sie auf eine exakte Größe an, sobald Ihre Nutzer sie hochladen.

  • Office-Dateien in PDF konvertieren

    Word, Excel, PowerPoint, OpenDocument und HTML in PDF, mit Layouts, die halten.

  • Scans durchsuchbar machen

    Texterkennung in 27 Sprachen, PDF/A für Archive und Tabellen direkt nach Excel.

  • Vereinbarungen aus Ihrer eigenen App senden

    Erstellen Sie ein Dokument aus einer PDF, platzieren Sie Felder mit Text-Tags, senden Sie es und laden Sie die signierte Kopie herunter.

  • Signieren in Ihr Produkt einbetten

    Öffnen Sie eine Signatursitzung auf Ihrer Website, beschränkt auf die von Ihnen erlaubten Origins.

  • Stapel mit Webhooks verarbeiten

    Starten Sie Hunderte von Aufgaben und erhalten Sie einen signierten Callback, sobald jede fertig ist.

So funktioniert es

Vom Schlüssel zum Ergebnis in vier Aufrufen

  1. Schlüssel erstellen

    Erstellen Sie in Ihrem Konto einen Sandbox-Schlüssel. Wechseln Sie zu einem Live-Schlüssel, wenn Sie bereit sind.

    Konto › Entwickler
  2. Eine Aufgabe starten

    Senden Sie die Dateien und das Tool in einer einzigen Multipart-Anfrage.

    POST /public/v1/tasks
  3. Erfahren, wann es fertig ist

    Abonnieren Sie task_completed oder fragen Sie die Aufgabe per Polling ab.

    webhook: task_completed
  4. Herunterladen

    Rufen Sie das Ergebnis ab und löschen Sie es dann oder lassen Sie es ablaufen.

    GET /tasks/{id}/download

Endpunkte

Eine kleine, vorhersehbare API

Basis-URL https://macaaw.com/public/v1 · JSON mit snake_case-Schlüsseln · Authorization: API-Key …

Vollständige API-Referenz

Aufgaben · PDF-Tools

  • GET/toolsJedes aufrufbare Tool mit seinen Optionen
  • POST/tasksDateien hochladen und ein Tool in einem Aufruf starten
  • GET/tasks/{id}Status: queued, processing, completed oder failed
  • GET/tasks/{id}/downloadDie Ergebnisdatei oder ein ZIP
  • DELETE/tasks/{id}Die Dateien sofort löschen

Dokumente · E-Signaturen

  • POST/documentsEine PDF plus Empfänger und Felder oder Text-Tags
  • POST/documents/{id}/sendPer E-Mail senden oder still für eingebettetes Signieren
  • GET/documents/{id}/detailsEmpfänger, Felder und der vollständige Verlauf
  • POST/documents/{id}/sessionEin Signaturlink für Ihre eigene Seite
  • GET/documents/{id}/downloadDie signierte PDF mit ihrem Zertifikat

Webhooks

  • POST/webhook-subscriptionsWählen Sie Auslöser wie task_completed oder document_state_changed
  • GET/webhook-eventsZustellverlauf, mit erneutem Senden

Sicherheit

Von Anfang an für die Produktion gebaut

Dieselben Löschregeln und dieselbe Verarbeitung im Vereinigten Königreich wie auf der Website, plus die Kontrollen, die ein Entwicklungsteam erwartet.

  • Schlüssel unter Ihrer KontrolleLive- und Sandbox-Schlüssel, einmal angezeigt und als Hash gespeichert. Widerrufen Sie jeden Schlüssel in Ihrem Konto.
  • Signierte WebhooksJede Zustellung enthält ?signature= mit einem HMAC-SHA256 des Inhalts, erstellt mit Ihrem gemeinsamen Schlüssel.
  • Dateien schnell gelöschtAufgabendateien werden bei einem kostenlosen Konto 1 Stunde und bei Pro und Business 2 Stunden aufbewahrt, dann sind sie weg. DELETE entfernt sie sofort.
  • Verarbeitung im Vereinigten KönigreichJede Aufgabe läuft auf unseren Servern in London. Anfrageprotokolle speichern nie Dateiinhalte oder Dateinamen.
  • Faire Ratenlimits120 neue Aufgaben pro Minute und Nutzer, mit Retry-After bei jedem 429.
  • Sichere WiederholungenSenden Sie einen Idempotency-Key, und eine wiederholte Anfrage liefert 24 Stunden lang das erste Ergebnis.

Preise

Kostenlos starten. Mit dem Bedarf wachsen.

Sandbox

0 £

  • Jeder Endpunkt, mit Testdaten
  • 10 Anfragen pro Minute
  • Bis zu 5 Seiten pro Aufgabe
  • Ergebnisse mit Stempel „Sandbox“
  • Testdaten nach 7 Tagen gelöscht
Sandbox-Schlüssel holen

Live, mit Pro oder Business

Ab 4,99 £pro Monat, jährliche Abrechnung

  • Nutzt die Monatskontingente Ihres Tarifs
  • Danach Credits: ab 5 £ für 500
  • 1 Credit pro OCR-Seite, 2 Credits pro Office-Konvertierung
  • 120 neue Aufgaben pro Minute
Tarife vergleichen

Enterprise

Mengenpreise

  • Mengenpreise für Seiten und Konvertierungen
  • Individuelle Limits, per Vertrag
  • Jährliche Abrechnung per Rechnung
  • Ein persönlicher Ansprechpartner
Kontakt aufnehmen

Fragen

Entwickler fragen

Gibt es eine kostenlose Möglichkeit, die API auszuprobieren?

Ja. Jeder angemeldete Nutzer kann kostenlos einen Sandbox-Schlüssel erstellen. Sandbox-Aufrufe sind auf 10 pro Minute und 5 Seiten pro Aufgabe begrenzt, jedes Ergebnis trägt den Stempel „Sandbox“, und Testdaten werden nach 7 Tagen gelöscht.

Welche Tools kann ich aufrufen?

Die 20 Tools, die auf unseren Servern laufen – von Komprimieren und OCR bis zu Office-Konvertierungen und PDF/A – sowie E-Signaturen. GET /tools listet sie mit ihren Optionen auf. Die 20 Browser-Tools laufen in den Browsern Ihrer Nutzer und sind daher nicht in API v1 enthalten.

Wie wird die API-Nutzung abgerechnet?

Live-Schlüssel gibt es mit Pro und Business. Aufrufe nutzen dieselben Monatskontingente wie die Website; darüber hinaus gelten Credits. Credit-Pakete beginnen bei 5 £ für 500 Credits und sind 12 Monate gültig.

Gibt es SDKs?

Die Dokumentation enthält Beispiele zum Kopieren und Einfügen in curl, Node und Python für jeden Endpunkt, eine OpenAPI-3.1-Datei und eine Postman-Collection, sodass Sie einen Client in jeder Sprache generieren können.

Was passiert, wenn mein Webhook-Endpunkt nicht erreichbar ist?

Wir versuchen es noch dreimal, nach 1 Minute, 10 Minuten und 1 Stunde, und markieren die Zustellung dann als fehlgeschlagen. Sie können sie über Ihr Konto oder per API erneut senden.

PDF-Funktionen noch diese Woche ausliefern.

Erstellen Sie in einer Minute einen Sandbox-Schlüssel. Keine Karte nötig.