PDFHQ-logo

Documenten

DocumentatieAutomatisering en integraties

Automatiseringsoverzicht — Zapier, MCP en webhooks

Vergelijk privé Zapier-connectors, OAuth-gedelegeerde MCP-tools, ondertekende projectwebhooks en REST API-orchestratie, met implementatievereisten en beperkingen.

Server-side API-sleutels Ondertekende opslagupload

Kies het juiste automatiseringsoppervlak#

PDFHQ biedt verschillende integratieoppervlakken in plaats van één REST-eindpunt genaamd Zapier of MCP. De taak-API ondersteunt verwerking; projectwebhooks leveren gebeurtenissen; een onuitgegeven Zapier Platform CLI-app verpakt toegestane REST-bewerkingen; MCP stelt gedelegeerde OAuth-tools voor AI-agenten beschikbaar.

Directe API: gedocumenteerde taak, upload, AI en ondertekeningsroutes zijn toegankelijk met de juiste inloggegevens en accountmachtigingen. Zapier: bron is beschikbaar in integrations/zapier maar er is geen gepubliceerde app. MCP: lokale server bestaat; gehoste OAuth is staging-gated en niet gecertificeerd openbaar. Webhooks: source-eindpunten bestaan maar retourneren 503 tenzij ingeschakeld door een operator na setup en testen.

Zie het visuele integratieoverzicht →

Voorbeeld: PDF-taak → webhook → automatisering#

Dien eerst een projecteigen PDF-taak in met behulp van de normale API-levenscyclus. Abonneer u op de voltooide gebeurtenis alleen nadat uw implementatie webhooks, versleuteling en de leveringsworker heeft geactiveerd. Sla het geretourneerde ondertekeningsgeheim eenmaal op; controleer de exacte onbewerkte payload en wijs replay af voordat u downstreamautomatisering activeert.

Een privé-webhookabonnement maken
# 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.

De webhook-payload bevat metagegevens, geen PDF-bytes of ondertekende downloadlinks. Haal alle toegestane resultaten onafhankelijk op via geverifieerde PDFHQ-API's. Levering is minstens eenmaal, dus consumenten moeten duplicaten verwerken.

Webhook-gebeurtenissen, verificatie, pogingen en afspelen →

Zapier: privé-app-bron#

Project-key-authenticatie maakt PDF/AI-job-triggers en -acties mogelijk, met ondertekende REST Hooks voor ondersteunde projectgebeurtenissen en polling-fallback. Een geautoriseerd document moet al zijn geüpload via de sealed upload-flow. De app kan alleen onverzonden sandbox-handtekeningconcepten voorbereiden; deze kan geen live-uitnodigingen verzenden.

Offline validatie (vóór privé Zapier CLI-setup)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Valideer de connector met een Zapier-ontwikkelaarsaccount en staging API voordat u iets publiceert. Deze repository bevat geen openbare Zapier-vermelding of installatiepagina met één klik.

Zapier-triggers, acties en beperkingen →

MCP: gedelegeerde AI-agententoegang#

MCP gebruikt HQTools OAuth Authorization Code + PKCE en audience-geverifieerde PDFHQ-bereiken. Het is geen API-sleutelvariant van Zapier en ontvangt geen webhooks. Lokale stdio kan worden getest met een afzonderlijk verkregen kortstondig token; het hosten van een externe MCP-server vereist operatorconfiguratie, PKCE en levenscyclusacceptatie.

Remote MCP-implementatiedoel — geen live verbindingsclaim
https://mcp.pdfhq.io/mcp

Toegestane tools omvatten PDF-taakstatus/indiening, AI-offertes/taken en beperkte handtekeningsstatus. Redactie, verwijdering, live handtekeningsverzending en credentialbeheer zijn opzettelijk uitgesloten van autonome tools. AI-uitvoering gaat door via HQTools-krediet en toestemmingsregels.

MCP OAuth-bereiken en staging-setup →

Andere workflowsystemen#

Native Make- en n8n-connectoren zijn niet geïmplementeerd of gepubliceerd. Hun HTTP-modules kunnen gedocumenteerde REST-bewerkingen aanroepen en compatibele HTTPS-eindpunten kunnen projectwebhooks ontvangen zodra deze zijn ingeschakeld. Configureer geen productieworkflows totdat projectauthenticatie, gebeurtenishandtekeningen, facturering en pogingen verbonden tests hebben doorstaan.

Bouwen met de REST-taak quickstart →
PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.