PDFHQ logosu

Belgeler

BelgelerOtomasyon ve Entegrasyonlar

Otomasyon özeti — Zapier, MCP ve web kancaları

Özel Zapier bağlayıcılarını, OAuth-delegeli MCP araçlarını, imzalı proje web kancalarını ve REST API orkestrasyonunu dağıtım ön koşulları ve sınırlamalarıyla karşılaştırın.

Sunucu tarafı API anahtarları İmzalı depolama yüklemeleri

Doğru otomasyon yüzeyini seçin#

PDFHQ, Zapier veya MCP adlı tek bir REST uç noktası yerine farklı entegrasyon yüzeyleri sunar. Görev API'si işlemeyi güçlendirir; proje web kancaları olayları iletir; yayınlanmamış bir Zapier Platform CLI uygulaması izin verilen REST işlemlerini sarmalanır; MCP, AI aracıları için devredilmiş OAuth araçlarını ortaya çıkarır.

Doğrudan API: belgelenen görev, yükleme, AI ve imzalama rotaları uygun kimlik bilgileri ve hesap izinleriyle erişilebilir. Zapier: kaynak şurada mevcuttur integrations/zapier ancak yayınlanmış bir uygulama yok. MCP: yerel sunucu var; barındırılan OAuth aşamalı geçitli ve sertifikalı genel değil. Web kancaları: kaynak uç noktaları mevcuttur ancak kurulum ve test sonrasında bir operatör tarafından etkinleştirilmediği sürece 503 döndürür.

Görsel entegrasyon özeti görüntüle →

Örnek: PDF işi → webhook → otomasyon#

Önce normal API yaşam döngüsünü kullanarak projeye ait bir PDF görevini gönderin. Dağıtımınız müşteri web kancalarını, şifrelemeyi ve teslimat çalışanını etkinleştirdikten sonra yalnızca tamamlanan olayına abone olun. Döndürülen imzalama sırrını bir kez saklayın; tam ham yükü doğrulayın ve yeniden oynatmayı reddedin, ardından aşağı akış otomasyonunu tetikleyin.

Özel webhook aboneliği oluşturun
# 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.

Webhook yükü meta verileri içerir, PDF baytları veya imzalı indirme bağlantılarını değil. Kimliği doğrulanmış PDFHQ API'leri aracılığıyla izin verilen sonuçları bağımsız olarak alın. Teslimat en az bir kez olur, bu nedenle tüketiciler yinelenenleri işlemelidir.

Webhook olayları, doğrulama, yeniden denemeler ve yeniden oynatma →

Zapier: özel uygulama kaynağı#

Proje anahtarı kimlik doğrulaması, PDF/AI iş tetikleyicilerini ve eylemlerini, desteklenen proje olayları için imzalı REST Hooks'ları ve yoklama geri dönüşünü etkinleştirir. Yetkili bir belge zaten mühürlü yükleme akışı aracılığıyla yüklenmiş olmalıdır. Uygulama yalnızca gönderilmemiş sandbox imza taslakları hazırlayabilir; canlı davetiye gönderemez.

Çevrimdışı doğrulama (özel Zapier CLI kurulumundan önce)
cd integrations/zapier
npm install
npm test
npx zapier-platform validate

Bağlayıcıyı bir Zapier geliştirici hesabı ve staging API ile doğrula ve herhangi bir şey yayınlamadan önce test et. Bu depo, halka açık bir Zapier listesi veya tek tıklamayla kurulum bağlantısı içermez.

Zapier tetikleyicileri, eylemleri ve sınırlamaları →

MCP: devredilen AI-aracı erişimi#

MCP, HQTools OAuth Yetkilendirme Kodu + PKCE ve hedef kitlesi doğrulanmış PDFHQ kapsamlarını kullanır. Zapier'in API anahtarı varyantı değildir ve webhook almaz. Yerel stdio ayrı olarak elde edilen kısa ömürlü bir belirteçle test edilebilir; uzak bir MCP sunucusu barındırmak operatör yapılandırması, PKCE ve yaşam döngüsü kabulü gerektirir.

Uzak MCP dağıtım hedefi — canlı bağlantı iddiası değil
https://mcp.pdfhq.io/mcp

İzin verilen araçlar PDF iş durumu/gönderimi, AI teklifleri/işleri ve sınırlı imza durumunu içerir. Redaksiyon, silme, canlı imza gönderimi ve kimlik bilgisi yönetimi kasıtlı olarak otonom araçlardan hariç tutulmuştur. AI yürütülmesi HQTools kredi ve onay kuralları aracılığıyla devam eder.

MCP OAuth kapsamları ve hazırlama kurulumu →

Diğer iş akışı sistemleri#

Yerel Make ve n8n bağlayıcıları uygulanmamış veya yayınlanmamıştır. HTTP modülleri belgelenen REST işlemlerini çağırabilir ve uyumlu HTTPS uç noktaları proje web kancaları etkinleştirildikten sonra alabilir. Proje kimlik doğrulaması, olay imzaları, faturalandırma ve yeniden denemeler bağlı testleri geçene kadar üretim iş akışlarını yapılandırmayın.

REST görev hızlı başlangıcı ile oluşturun →
PDFHQ logosu

PDF araçları ve belge zekası. Belgelerinizi hazırlayın, anlayın ve çalışın.

© 2026 PDFHQ. Tüm hakları saklıdır.