Ikhtisar otomasi — Zapier, MCP dan webhook
Bandingkan konektor Zapier pribadi, alat MCP yang didelegasikan OAuth, webhook proyek yang ditandatangani, dan orkestrasi REST API, dengan prasyarat dan batasan penerapan.
Pilih permukaan otomasi yang tepat#
PDFHQ menawarkan permukaan integrasi yang berbeda daripada satu titik akhir REST bernama Zapier atau MCP. API tugas mendukung pemrosesan; webhook proyek mengirimkan acara; aplikasi CLI Platform Zapier yang tidak dipublikasikan membungkus operasi REST yang diizinkan; MCP mengekspos alat OAuth yang didelegasikan untuk agen AI.
API Langsung: rute tugas terdokumentasi, unggah, AI dan penandatanganan dapat diakses dengan kredensial dan izin akun yang sesuai. Zapier: sumber tersedia di integrations/zapier tetapi tidak ada aplikasi yang dipublikasikan. PKS: server lokal ada; OAuth yang dihosting adalah staging gated dan tidak bersertifikat publik. Webhook: titik akhir sumber ada tetapi mengembalikan 503 kecuali diaktifkan oleh operator setelah penyiapan dan pengujian.
Contoh: Pekerjaan PDF → webhook → otomasi#
Pertama kali kirimkan tugas PDF milik proyek menggunakan siklus hidup API normal. Berlangganan acara yang diselesaikan hanya setelah penyebaran Anda telah mengaktifkan webhook pelanggan, enkripsi, dan pekerja pengiriman. Simpan rahasia penandatanganan yang dikembalikan sekali; verifikasi muatan baku yang tepat dan tolak putar ulang sebelum memicu otomasi hilir.
# 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.Muatan webhook berisi metadata, bukan byte PDF atau tautan unduhan yang ditandatangani. Ambil hasil yang diizinkan secara independen melalui API PDFHQ yang diautentikasi. Pengiriman setidaknya sekali, jadi konsumen harus menangani duplikat.
Acara webhook, verifikasi, percobaan ulang, dan putar ulang →Zapier: sumber aplikasi pribadi#
Autentikasi kunci proyek memungkinkan pemicu dan tindakan pekerjaan PDF/AI, dengan REST Hooks yang ditandatangani untuk acara proyek yang didukung dan fallback polling. Dokumen yang berwenang harus sudah diunggah melalui alur unggahan tersegel. Aplikasi hanya dapat menyiapkan draf tanda tangan sandbox yang belum dikirim; aplikasi tidak dapat mengirimkan undangan langsung.
cd integrations/zapier
npm install
npm test
npx zapier-platform validateValidasi konektor dengan akun pengembang Zapier dan API staging sebelum menerbitkan apa pun. Repositori ini tidak berisi daftar Zapier publik atau tautan instalasi sekali klik.
Pemicu, tindakan dan batasan Zapier →MCP: akses agen AI yang didelegasikan#
MCP menggunakan Kode Otorisasi PDFHQ OAuth + PKCE dan cakupan PDFHQ yang diverifikasi audiens. Ini bukan varian kunci API dari Zapier dan tidak menerima webhook. Stdio lokal dapat diuji dengan token berumur pendek yang diperoleh secara terpisah; menghosting server MCP jarak jauh memerlukan konfigurasi operator, PKCE dan penerimaan siklus hidup.
https://mcp.pdfhq.io/mcpAlat yang diizinkan mencakup status/pengajuan pekerjaan PDF, penawaran/pekerjaan AI, dan status penandatanganan terbatas. Redaksi, penghapusan, pengiriman penandatanganan langsung, dan administrasi kredensial sengaja dikecualikan dari alat otonom. Eksekusi AI berlanjut melalui aturan kredit dan persetujuan HQTools.
Cakupan OAuth MCP dan penyiapan staging →Sistem alur kerja lainnya#
Konektor Make dan n8n asli tidak diimplementasikan atau dipublikasikan. Modul HTTP mereka dapat memanggil operasi REST yang didokumentasikan, dan titik akhir HTTPS yang kompatibel dapat menerima webhook proyek setelah diaktifkan. Jangan konfigurasikan alur kerja produksi sampai otentikasi proyek, tanda tangan acara, penagihan, dan pengulangan lulus tes terhubung.
Bangun dengan panduan cepat tugas REST →