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.