ConverterHQDevelopers
API v1

Architettura della piattaforma

Comprendi control plane, data plane, storage, Jobs durevoli ed eventi.

ConverterHQ separa coordinamento API, movimento dei byte ed esecuzione dei converter affinché file grandi e Jobs lunghi continuino oltre la richiesta HTTP originale.

Architettura di esecuzione durevole
Client
Control plane
Files
Jobs + Tasks
Delivery
Trasferimento binario ed esecuzione sono indipendenti dalla durata della 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.