PDFHQ-Logo

Dokumente

DokumentationAutomatisierung & Integrationen

Automatisierungsübersicht — Zapier, MCP und Webhooks

Vergleiche private Zapier-Konnektoren, OAuth-delegierte MCP-Tools, signierte Projekt-Webhooks und REST-API-Orchestrierung mit Bereitstellungsvoraussetzungen und Einschränkungen.

Server-seitige API-Schlüssel Signierte Speicher-Uploads

Wähle die richtige Automatisierungsoberfläche#

PDFHQ bietet verschiedene Integrationsflächen statt eines einzelnen REST-Endpunkts namens Zapier oder MCP. Die Task-API steuert die Verarbeitung; Projekt-Webhooks liefern Ereignisse; eine unveröffentlichte Zapier-Plattform-CLI-App umhüllt zulässige REST-Operationen; MCP stellt delegierte OAuth-Tools für KI-Agenten bereit.

Direkte API: dokumentierte Aufgabe, Upload, KI- und Signing-Routen sind mit den entsprechenden Anmeldedaten und Kontoberechtigungen zugänglich. Zapier: Quelle ist verfügbar in integrations/zapier aber es gibt keine veröffentlichte App. MCP: Lokaler Server existiert; gehostetes OAuth ist Staging-gated und nicht zertifiziert öffentlich. Webhooks: Quellendpunkte existieren, geben aber 503 zurück, sofern sie nicht von einem Operator nach Setup und Tests aktiviert werden.

Visuelle Integrationsübersicht ansehen →

Beispiel: PDF-Auftrag → Webhook → Automatisierung#

Sende zunächst eine projektgesteuerte PDF-Task mit dem normalen API-Lebenszyklus. Abonniere das abgeschlossene Ereignis erst, nachdem deine Bereitstellung Kunden-Webhooks, Verschlüsselung und den Lieferworker aktiviert hat. Speichere das zurückgegebene Signier-Geheimnis einmalig; validiere die genaue Rohdaten-Nutzlast und lehne Wiederholungen ab, bevor du nachgelagerte Automatisierung auslöst.

Erstelle ein privates Webhook-Abonnement
# Staging only: project API key stored on your server.
curl -X POST 'https://api.pdfhq.io/v1/webhooks' \
  -H 'x-api-key: YOUR_PROJECT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"target_url":"https://your-app.example/events/pdfhq","events":["pdf.job.succeeded","ai.job.succeeded"]}'
# The first response includes a one-time HMAC signing secret.
# Verify X-PDFHQ-Webhook-Timestamp and X-PDFHQ-Webhook-Signature: v1=...;
# reject old messages and deduplicate on the event ID.

Die Webhook-Nutzlast enthält Metadaten, keine PDF-Bytes oder signierte Download-Links. Rufe alle zulässigen Ergebnisse unabhängig über authentifizierte PDFHQ-APIs ab. Die Zustellung erfolgt mindestens einmal, daher müssen Consumer Duplikate verarbeiten.

Webhook-Events, Verifizierung, Wiederholungen und Replay →

Zapier: private App-Quelle#

Die Projekt-Schlüssel-Authentifizierung ermöglicht PDF/AI-Job-Auslöser und -Aktionen mit signierten REST Hooks für unterstützte Projektereignisse und Polling-Fallback. Ein autorisiertes Dokument muss bereits über den versiegelten Upload-Flow hochgeladen sein. Die App kann nur ungesendete Sandbox-Signaturentwürfe vorbereiten; sie kann keine Live-Einladungen versenden.

Offline-Validierung (vor privatem Zapier CLI-Setup)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Validiere den Connector mit einem Zapier-Entwicklerkonto und der Staging-API, bevor du etwas veröffentlichst. Dieses Repository enthält keine öffentliche Zapier-Auflistung oder einen One-Click-Install-Link.

Zapier-Trigger, Aktionen und Einschränkungen →

MCP: delegierter KI-Agent-Zugriff#

MCP verwendet HQTools OAuth Authorization Code + PKCE und audience-verified PDFHQ-Bereiche. Es ist keine API-Schlüssel-Variante von Zapier und empfängt keine Webhooks. Lokales stdio kann mit einem separat erhaltenen kurzlebigen Token getestet werden; das Hosten eines Remote-MCP-Servers erfordert Operator-Konfiguration, PKCE und Lifecycle-Akzeptanz.

Remote-MCP-Bereitstellungsziel — keine Live-Verbindungsbehauptung
https://mcp.pdfhq.io/mcp

Zulässige Tools umfassen PDF-Job-Status/Einreichung, KI-Angebote/Jobs und begrenzte Signaturabrufstatus. Schwärzung, Löschung, Live-Signaturversand und Anmeldungsverwaltung sind absichtlich von autonomen Tools ausgeschlossen. Die KI-Ausführung wird durch HQTools-Guthaben und Zustimmungsregeln fortgesetzt.

MCP OAuth-Bereiche und Staging-Setup →

Andere Workflow-Systeme#

Native Make- und n8n-Konnektoren sind nicht implementiert oder veröffentlicht. Ihre HTTP-Module können dokumentierte REST-Operationen aufrufen, und kompatible HTTPS-Endpunkte können Projekt-Webhooks empfangen, sobald diese aktiviert sind. Konfiguriere keine Produktions-Workflows, bis Projekt-Auth, Event-Signaturen, Abrechnung und Wiederholungen verbundene Tests bestanden haben.

Baue mit der REST-Task-Schnellstarthilfe →
PDFHQ-Logo

PDF-Werkzeuge und Dokumentenanalyse. Dokumente vorbereiten, verstehen und bearbeiten.

© 2026 PDFHQ. Alle Rechte vorbehalten.