ConverterHQ separa coordinación API, movimiento de bytes y ejecución de convertidores para que archivos grandes y Jobs largos sobrevivan a la petición HTTP original.
Planos de control y datos
La API autentica, valida capabilities/settings y registra Files, Jobs y Tasks. Los bytes viajan mediante almacenamiento firmado; los workers consumen después las Tasks en cola.
Modelo de recursos
Files representan binarios duraderos. Jobs agrupan un DAG de Tasks y attempts conserva historial físico. Workflows versionan grafos reutilizables y Connections aíslan secretos cloud.
Ciclo de ejecución
REST es el estado autoritativo. Los webhooks aportan entrega duradera al menos una vez; WebSocket/SSE proyectan progreso en tiempo real sin sustituir REST.
Implicaciones de diseño
Persiste IDs, usa Idempotency-Key, transfiere archivos grandes directamente y ejecuta automatización de producción mediante Jobs + webhooks, no conexiones HTTP largas.