ConverterHQDevelopers
API v1

Jobs et Tasks

Construisez des DAG de conversion avec branches parallèles, retries et historique durable.

Un Job est un graphe acyclique de Tasks nommées. Les branches indépendantes s’exécutent en parallèle et les dépendances contrôlent l’ordonnancement.

Modèle d’exécution

Les Tasks d’import produisent des Files, les Tasks convert les transforment et les Tasks export livrent les résultats. Chaque exécution physique est conservée comme TaskAttempt.

Exemple de Job

Déclarez les tâches par nom et référencez les sorties de tâches précédentes. ConverterHQ valide les dépendances et rejette les cycles avant l’exécution.

Requête Job
{
  "tasks": {
    "source": {"operation": "import/url", "input": {"url": "https://example.com/report.docx"}},
    "pdf": {"operation": "convert", "input": "source", "options": {"output_format": "pdf"}},
    "delivery": {"operation": "export/s3", "input": "pdf", "options": {"connection": "conn_...", "key": "processed/report.pdf"}}
  }
}

Retries et échecs

Les retries d’infrastructure, le fallback moteur et les retries demandés par le client sont distincts. Un nouvel essai crée un nouvel historique au lieu d’effacer l’échec précédent.

Annulation

L’annulation empêche les tâches en attente de démarrer, invalide les éléments en file et signale aux workers actifs de terminer proprement les processus de conversion.