ConverterHQ rozdziela koordynację API, transfer bajtów i wykonanie konwerterów, dzięki czemu duże pliki i długie Jobs żyją niezależnie od początkowego requestu HTTP.
Control i data plane
API uwierzytelnia, waliduje capabilities/settings i zapisuje Files, Jobs oraz Tasks. Bajty trafiają signed transferem do object storage; workers wykonują Tasks z kolejki.
Model zasobów
Files to trwałe binary assets. Jobs grupują DAG Tasks, a attempts zachowują historię wykonania. Workflows wersjonują grafy, Connections izolują cloud secrets.
Cykl wykonania
REST jest autorytatywnym stanem. Webhooks zapewniają trwałe at-least-once delivery; WebSocket/SSE pokazują realtime progress.
Konsekwencje projektowe
Persistuj resource IDs, stosuj Idempotency-Key, wysyłaj duże pliki bezpośrednio i buduj automatyzację na Jobs + webhooks.