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.