ConverterHQDevelopers
API v1

Arsitektur platform

Pahami control plane, data plane, storage, durable Jobs, dan event model.

ConverterHQ memisahkan koordinasi API, pergerakan byte, dan eksekusi converter agar file besar dan Job panjang tetap berjalan setelah request HTTP awal selesai.

Arsitektur eksekusi durable
Client
Control plane
Files
Jobs + Tasks
Delivery
Transfer biner dan eksekusi konversi dipisahkan dari umur request HTTP awal.

Control plane dan data plane

API mengautentikasi, memvalidasi capabilities/settings, dan mencatat Files, Jobs, serta Tasks. Byte file memakai signed object-storage transfer; worker memproses Tasks dari queue.

Model resource

Files adalah aset biner durable. Jobs menampung DAG Tasks; attempts menyimpan histori eksekusi. Workflows mem-version graph dan Connections mengisolasi secret cloud.

Lifecycle eksekusi

REST adalah state otoritatif. Webhooks memberi delivery durable at-least-once; WebSocket/SSE memproyeksikan progress realtime.

Implikasi desain

Persist resource ID, gunakan Idempotency-Key, transfer file besar langsung, dan gunakan Jobs + webhooks untuk automasi produksi.