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.
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.