ConverterHQDevelopers
API v1

Concevoir Jobs et workflows

Modéliser DAG, parallélisme et dépendances avant la production.

Un Job est un graphe acyclique dirigé et non un script séquentiel. Chaque Task nommée déclare son opération, ses entrées, ses options et ses dépendances.

Raisonner en DAG

Les Tasks indépendantes doivent être sœurs afin que le scheduler puisse les exécuter en parallèle. Les dépendances expriment uniquement les vrais prérequis de données.

Paralléliser ce qui est indépendant

Si un même document produit PDF, miniature et texte, créez trois branches. La concurrence réelle reste bornée par le plan et l’équité du scheduler.

Choisir les frontières de Task

Créez une Task quand vous avez besoin d’un retry, d’une mesure, d’un fan-out/fan-in ou d’un effet externe distinct. Gardez les paramètres moteur dans settings.

Valider avec le Job Builder

Le studio vérifie localement cycles et dépendances puis produit le JSON exact pour POST /v1/jobs. POST /v1/jobs/validate reste l’autorité pour capabilities, settings, quotas et compte.