ConverterHQDevelopers
API v1

Architecture de la plateforme

Comprendre plans de contrôle et de données, stockage, Jobs durables et événements.

ConverterHQ sépare la coordination API du déplacement des octets et de l’exécution des convertisseurs afin qu’un gros fichier ou un Job long survive à la requête HTTP initiale.

Architecture d’exécution durable
Client
Control plane
Files
Jobs + Tasks
Delivery
Le transfert binaire et l’exécution sont indépendants de la durée de la requête HTTP initiale.

Plans de contrôle et de données

L’API authentifie, valide les capabilities/settings et enregistre Files, Jobs et Tasks. Les fichiers utilisent des transferts signés vers le stockage objet; les workers exécutent ensuite les Tasks mises en file.

Modèle de ressources

Files représentent les objets binaires durables. Jobs regroupent un DAG de Tasks; les attempts conservent l’historique physique. Workflows versionnent des graphes réutilisables et Connections isolent les secrets cloud.

Cycle d’exécution

REST est l’état autoritatif. Les webhooks fournissent une notification durable au moins une fois; WebSocket/SSE projettent la progression en temps réel sans remplacer REST.

Conséquences de conception

Persistez les IDs de ressources, utilisez Idempotency-Key sur les créations, transférez les gros fichiers directement et placez les traitements de production derrière Jobs + webhooks plutôt qu’une connexion HTTP longue.