Logo PDFHQ

Documenti

DocumentazioneAutomazione e integrazioni

Panoramica dell'automazione — Zapier, MCP e webhook

Confronta connettori Zapier privati, strumenti MCP delegati OAuth, webhook di progetto firmati e orchestrazione API REST, con prerequisiti di distribuzione e limitazioni.

Chiavi API lato server Caricamenti di archiviazione firmati

Scegli la giusta superficie di automazione#

PDFHQ offre diverse superfici di integrazione piuttosto che un singolo endpoint REST denominato Zapier o MCP. L'API task alimenta l'elaborazione; i webhook del progetto forniscono eventi; un'app CLI Zapier Platform non pubblicata racchiude le operazioni REST consentite; MCP espone strumenti OAuth delegati per agenti AI.

API diretta: attività documentata, caricamento, le route di AI e firma sono accessibili con le credenziali e i permessi account appropriati. Zapier: la fonte è disponibile in integrations/zapier ma non c'è un'app pubblicata. MCP: esiste un server locale; OAuth ospitato è in staging con gate e non certificato pubblico. Webhook: gli endpoint di origine esistono ma restituiscono 503 a meno che non siano abilitati da un operatore dopo la configurazione e il test.

Vedi la panoramica dell'integrazione visiva →

Esempio: lavoro PDF → webhook → automazione#

Per prima cosa invia un task PDF di proprietà del progetto utilizzando il normale ciclo di vita dell'API. Sottoscrivi l'evento completato solo dopo che la tua distribuzione ha attivato i webhook dei clienti, la crittografia e il worker di consegna. Archivia il segreto di firma restituito una sola volta; verifica il payload grezzo esatto e rifiuta la riproduzione prima di attivare l'automazione a valle.

Crea un abbonamento webhook privato
# 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.

Il payload del webhook contiene metadati, non byte PDF o link di download firmati. Recupera i risultati consentiti in modo indipendente tramite le API PDFHQ autenticate. La consegna è almeno una volta, quindi i consumer devono gestire i duplicati.

Eventi webhook, verifica, tentativi e riproduzione →

Zapier: sorgente app privata#

L'autenticazione con chiave di progetto abilita i trigger e le azioni dei lavori PDF/AI, con REST Hooks firmati per gli eventi di progetto supportati e fallback di polling. Un documento autorizzato deve essere già caricato tramite il flusso di caricamento sigillato. L'app può solo preparare bozze di firma sandbox non inviate; non può inviare inviti live.

Convalida offline (prima della configurazione privata di Zapier CLI)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Convalida il connettore con un account sviluppatore Zapier e l'API di staging prima di pubblicare qualsiasi cosa. Questo repository non contiene un elenco Zapier pubblico o un link di installazione con un clic.

Trigger, azioni e limitazioni di Zapier →

MCP: accesso delegato all'agente IA#

MCP utilizza HQTools OAuth Authorization Code + PKCE e scope PDFHQ verificati per audience. Non è una variante di chiave API di Zapier e non riceve webhook. Lo stdio locale può essere testato con un token di breve durata ottenuto separatamente; l'hosting di un server MCP remoto richiede configurazione dell'operatore, PKCE e accettazione del ciclo di vita.

Destinazione distribuzione MCP remota — non un'affermazione di connessione live
https://mcp.pdfhq.io/mcp

Gli strumenti consentiti includono stato/invio del lavoro PDF, preventivi/lavori AI e stato di firma limitato. Redazione, eliminazione, invio di firma in diretta e amministrazione delle credenziali sono deliberatamente esclusi dagli strumenti autonomi. L'esecuzione AI continua attraverso le regole di credito e consenso di HQTools.

Ambiti OAuth MCP e configurazione di staging →

Altri sistemi di workflow#

I connettori nativi Make e n8n non sono implementati o pubblicati. I loro moduli HTTP possono chiamare operazioni REST documentate e gli endpoint HTTPS compatibili possono ricevere webhook del progetto una volta abilitati. Non configurare flussi di lavoro di produzione fino a quando l'autenticazione del progetto, le firme degli eventi, la fatturazione e i tentativi non superano i test connessi.

Inizia con la guida rapida delle attività REST →
Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.