ConverterHQ scheidt API-coördinatie, bytetransfer en converteruitvoering zodat grote bestanden en lange Jobs onafhankelijk van de oorspronkelijke HTTP-request doorgaan.
Control en data plane
De API authenticeert, valideert capabilities/settings en registreert Files, Jobs en Tasks. Bytes gaan via signed object storage; workers voeren gequeue-de Tasks uit.
Resourcemodel
Files zijn duurzame binaries. Jobs bevatten een DAG van Tasks; attempts bewaren uitvoeringhistorie. Workflows versioneren grafen en Connections isoleren cloudsecrets.
Uitvoeringscyclus
REST is de autoritatieve status. Webhooks leveren duurzame at-least-once meldingen; WebSocket/SSE projecteren realtime voortgang.
Ontwerpgevolgen
Bewaar resource-IDs, gebruik Idempotency-Key, upload grote bestanden direct en gebruik Jobs + webhooks voor productieautomatisering.