PDFHQ logosu

Belgeler

BelgelerOtomasyon ve Entegrasyonlar

Müşteri Web Kancaları ve Olay Teslimi

İşlemsel PDFHQ olay giden kutusundan imzalı, kapsamlı HTTPS teslimi: abone ol, döndür, yeniden oynat, abonelikten çık. Hazırlık kabulüne kadar varsayılan olarak devre dışı.

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

Dayanıklı olay modeli ve kapı kontrolü#

PDFHQ, seçilen PDF, AI ve imzalama durumu geçişlerini, durum değişikliğiyle aynı veritabanı işleminde yakalar. Ayrı bir worker, kapsamlı olayları dağıtır ve yalnızca meta veri içeren HTTPS POST'larını imzalar. Özellikler şu şekilde devre dışı bırakılır: PDFHQ_CUSTOMER_WEBHOOKS_ENABLED=true ve operatör dayanıklı bir şifreleme anahtarı ve planlı çalışan sağlar. Bu kaynak uygulaması, üretim teslim SLA'sı değildir.

Proje sahipliği şu adresten çözümlenir: x-api-key HQTools'e ait. Tarayıcı tabanlı işler otomatik olarak diğer projelere yayınlanmaz. Olay türleri: pdf.job.succeeded, pdf.job.failed, ai.job.succeeded, ai.job.failed, signature.sent, signature.viewed, signature.declined, signature.archived, signature.voided, integration.test. Arşivlenmiş, imzalı çıktının doğrulandığı ve depolandığı anlamına gelir; gönderilen/görüntülenen imzalama işleminin tamamlandığını göstermez.

Abone ol, doğrula ve iptal et
# API key must be held in a server-side secret store.
curl -X POST 'https://api.pdfhq.io/v1/webhooks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"target_url":"https://customer.example.com/pdfhq/events","events":["pdf.job.succeeded","ai.job.succeeded"]}'
# Save the returned secret once: verify HMAC SHA-256 over timestamp + "." + exact JSON bytes.
# Headers: X-PDFHQ-Webhook-Id, X-PDFHQ-Webhook-Timestamp, X-PDFHQ-Webhook-Signature: v1=hex
# Reject payloads older than 300 seconds. Dedupe on event id.
curl -X DELETE 'https://api.pdfhq.io/v1/webhooks/SUBSCRIPTION_UUID' -H 'x-api-key: YOUR_API_KEY'

Teslimat yeniden denemeleri, döndürme ve gizlilik#

Olaylar en az bir kez teslim edilir; alıcılar olay kimliğine göre çoğaltmayı kaldırmalıdır. Geçici ağ hatalarını, HTTP 408, 429 ve 5xx'i sınırlı geri alma ile yeniden deneyin; HTTP 3xx ve diğer çoğu 4xx terminal olup yönlendirmeler asla izlenmez. Sekiz denemeden sonra teslim ölü hale gelir ve açıkça yeniden oynatılabilir. Görüntüle GET /v1/webhooks/deliveries?subscription_id=UUID ; şu aracılığıyla yeniden oynat POST /v1/webhooks/deliveries/UUID/replay. Sırlar şu şekilde döndürülebilir: POST /v1/webhooks/UUID/rotate, yeni anahtarı bir kez ortaya çıkararak. Tüketiciler yeni anahtarı hemen yüklemeli; imzalama sırrını döndürürken Zap'ı yeniden bağlayın.

Yalnızca kaynak türü, işlem, olay kimliği ve kaynak kimliği iletilir. PDF baytları, AI yanıtları, imzalayan e-postası, imzalı URL'ler ve faturalandırma sırları hariç tutulur. Tüm teslim hedefleri genel HTTPS adreslerine çözümlenmelidir, gönderme sırasında sabitlenmiş IP ve TLS ana bilgisayar adı doğrulaması ile yeniden doğrulanır. Geri arama URL'lerine hassas sorgu parametreleri gömmeyi önleyin.

Zapier özel bağlayıcı →
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.