ConverterHQ separa coordenação da API, movimento de bytes e execução dos conversores para que arquivos grandes e Jobs longos sobrevivam à requisição HTTP original.
Planos de controle e dados
A API autentica, valida capabilities/settings e registra Files, Jobs e Tasks. Bytes usam transferências assinadas para object storage; workers executam as Tasks enfileiradas.
Modelo de recursos
Files são binários duráveis. Jobs agrupam um DAG de Tasks; attempts preservam histórico físico. Workflows versionam grafos e Connections isolam segredos de cloud.
Ciclo de execução
REST é o estado autoritativo. Webhooks entregam notificações duráveis pelo menos uma vez; WebSocket/SSE projetam progresso em tempo real.
Implicações de design
Persista IDs, use Idempotency-Key, transfira arquivos grandes diretamente e prefira Jobs + webhooks para automação de produção.