ConverterHQDevelopers
API v1

Zapier

Resmî Zapier action ve trigger'larıyla dönüştürmeleri otomatikleştirin.

ConverterHQ Zapier uygulaması OAuth ve özel entegrasyonlarla aynı REST, capability ve webhook sözleşmelerini kullanır.

Kimlik doğrulama

Hesabı HQTools OAuth ile bağlayın. Grant’ler scoped ve revoke edilebilir; conversion action File write içerir çünkü basit conversion önce owned input File oluşturur.

Actions

Files dönüştürün, Jobs oluşturup yönetin, Workflows çalıştırın, conversion tahmin edin ve signed URL oluşturun. Dinamik alanlar capability graph’tan gelir.

Instant triggers

Job/conversion başarı ve hataları durable webhook sistemiyle gelir. Delivery at-least-once’dır; hassas side effect’leri deduplicate edin.

Workflow verisi

Run Workflow doğrulanmış değişkenleri, metadata ve client_reference_id değerini kabul eder. Kaynak olayın kararlı kimliğini business_event_id alanına eşleyin. ConverterHQ bu kimliği idempotency key’e dönüştürür; taşıma retry’ı aynı run’ı kullanırken sonraki olay yeni iş oluşturur.

Zap işletimi

Convert a File hâlâ işlenen bir dönüşümü aynı business_event_id kimliğiyle yeniden dener ve tamamlanmamış sonucu sonraki adıma göndermez. Uzun ve fan-out workflow’larda downstream adımlarından önce completion webhook trigger’ını tercih edin.