ConverterHQDevelopers
API v1

Arquitetura da plataforma

Entenda control plane, data plane, armazenamento, Jobs duráveis e eventos.

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.

Arquitetura de execução durável
Client
Control plane
Files
Jobs + Tasks
Delivery
Transferência binária e execução ficam desacopladas da duração da 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.