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
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
Schlüssel erstellen
Erstellen Sie in Ihrem Konto einen Sandbox-Schlüssel. Wechseln Sie zu einem Live-Schlüssel, wenn Sie bereit sind.
Konto › EntwicklerEine Aufgabe starten
Senden Sie die Dateien und das Tool in einer einzigen Multipart-Anfrage.
POST /public/v1/tasksErfahren, wann es fertig ist
Abonnieren Sie task_completed oder fragen Sie die Aufgabe per Polling ab.
webhook: task_completedHerunterladen
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 …
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
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
Enterprise
Mengenpreise
- Mengenpreise für Seiten und Konvertierungen
- Individuelle Limits, per Vertrag
- Jährliche Abrechnung per Rechnung
- Ein persönlicher Ansprechpartner
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.