ConverterHQ separa coordinamento API, movimento dei byte ed esecuzione dei converter affinché file grandi e Jobs lunghi continuino oltre la richiesta HTTP originale.
Piani di controllo e dati
L’API autentica, valida capabilities/settings e registra Files, Jobs e Tasks. I byte usano trasferimenti firmati verso object storage; i worker elaborano le Tasks in coda.
Modello delle risorse
Files sono asset binari durevoli. Jobs raggruppano un DAG di Tasks; attempts conservano la storia fisica. Workflows versionano grafi e Connections isolano i segreti cloud.
Ciclo di esecuzione
REST è lo stato autorevole. I webhook offrono consegna durevole at-least-once; WebSocket/SSE proiettano il progresso realtime.
Implicazioni di design
Persisti gli ID, usa Idempotency-Key, trasferisci grandi file direttamente e usa Jobs + webhook per automazione di produzione.