ConverterHQDevelopers
API v1

Arquitectura de la plataforma

Comprende control plane, data plane, almacenamiento, Jobs duraderos y eventos.

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.

Arquitectura de ejecución duradera
Client
Control plane
Files
Jobs + Tasks
Delivery
La transferencia binaria y la ejecución están desacopladas de la duración de la solicitud 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.