ConverterHQ memisahkan koordinasi API, pergerakan byte, dan eksekusi converter agar file besar dan Job panjang tetap berjalan setelah request HTTP awal selesai.
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.