ConverterHQDevelopers
API v1

Platformarchitectuur

Begrijp control plane, data plane, storage, duurzame Jobs en events.

ConverterHQ scheidt API-coördinatie, bytetransfer en converteruitvoering zodat grote bestanden en lange Jobs onafhankelijk van de oorspronkelijke HTTP-request doorgaan.

Duurzame uitvoeringsarchitectuur
Client
Control plane
Files
Jobs + Tasks
Delivery
Binaire overdracht en conversie-uitvoering zijn losgekoppeld van de levensduur van de oorspronkelijke HTTP-request.

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.