ConverterHQ trennt API-Koordination von Byte-Transfer und Converter-Ausführung, damit große Dateien und lange Jobs unabhängig vom ursprünglichen HTTP-Request weiterlaufen.
Control und Data Plane
Die API authentifiziert, validiert capabilities/settings und speichert Files, Jobs und Tasks. Datei-Bytes gehen per signiertem Object-Storage-Transfer; Worker führen anschließend die gequeueten Tasks aus.
Ressourcenmodell
Files sind dauerhafte Binärassets. Jobs enthalten einen DAG aus Tasks; attempts bewahren physische Historie. Workflows versionieren wiederverwendbare Graphen und Connections kapseln Cloud-Secrets.
Ausführungslebenszyklus
REST ist autoritativer Zustand. Webhooks liefern durable at-least-once Benachrichtigung; WebSocket/SSE projizieren Fortschritt in Echtzeit und ersetzen REST nicht.
Designfolgen
Persistieren Sie Ressourcen-IDs, nutzen Sie Idempotency-Key, laden Sie große Dateien direkt hoch und bauen Sie Produktionsautomatisierung auf Jobs + Webhooks statt langen HTTP-Verbindungen.