Automatiseringsoverzicht — Zapier, MCP en webhooks
Vergelijk privé Zapier-connectors, OAuth-gedelegeerde MCP-tools, ondertekende projectwebhooks en REST API-orchestratie, met implementatievereisten en beperkingen.
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.
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.
# 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.
cd integrations/zapier
npm install
npm test
npx zapier-platform validateValideer 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.
https://mcp.pdfhq.io/mcpToegestane 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 →