ConverterHQDevelopers
API v1

Plattformarchitektur

Control Plane, Data Plane, Storage, dauerhafte Jobs und Events verstehen.

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.

Dauerhafte Ausführungsarchitektur
Client
Control plane
Files
Jobs + Tasks
Delivery
Binärtransfer und Konvertierung sind von der Lebensdauer der ursprünglichen HTTP-Anfrage entkoppelt.

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.