ConverterHQDevelopers
API v1

Zapier

Otomatiskan konversi dengan action dan trigger Zapier resmi.

Aplikasi Zapier memakai OAuth serta kontrak REST, capability, dan webhook yang sama seperti integrasi custom.

Autentikasi

Hubungkan akun melalui OAuth HQTools. Grant scoped dan dapat dicabut; action konversi mencakup File write karena konversi sederhana membuat File input owned terlebih dahulu.

Actions

Konversi File, buat/kelola Job, jalankan Workflow, estimasi konversi, dan buat signed URL. Field dinamis berasal dari capability graph.

Instant triggers

Sukses/gagal Job atau konversi dikirim melalui sistem webhook durable. Delivery minimal sekali; deduplikasi side effect sensitif.

Data Workflow

Run Workflow menerima variabel tervalidasi, metadata, dan client_reference_id. Petakan ID event sumber yang stabil ke business_event_id. ConverterHQ mengubah identitas tersebut menjadi kunci idempotensi sehingga retry transport memakai kembali run yang dimaksud, sedangkan event berikutnya membuat pekerjaan baru.

Mengoperasikan Zap

Convert a File mencoba lagi konversi yang masih diproses dengan identitas business_event_id yang sama, bukan meneruskan hasil yang belum selesai ke langkah berikutnya. Untuk workflow panjang dan fan-out, gunakan trigger webhook penyelesaian sebagai batas sebelum langkah downstream.