ConverterHQDevelopers
API v1

Architektura platformy

Zrozum control plane, data plane, storage, trwałe Jobs i model eventów.

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.

Trwała architektura wykonania
Client
Control plane
Files
Jobs + Tasks
Delivery
Transfer binarny i wykonanie konwersji są niezależne od czasu życia pierwotnego żądania 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.