ConverterHQDevelopers
API v1

Progettare Jobs e workflow

Modella DAG, parallelismo e dipendenze prima della produzione.

Un Job è un grafo aciclico diretto, non uno script sequenziale. Ogni Task nominata dichiara operation, input, options e dipendenze.

Pensare in DAG

Modella le Tasks indipendenti come rami fratelli così lo scheduler può eseguirle in parallelo. Le dipendenze esprimono solo prerequisiti reali.

Parallelizzare il lavoro indipendente

Se un upload produce PDF, thumbnail e testo, crea tre rami. La concorrenza resta limitata dal piano e dalla fairness.

Scegliere i confini delle Task

Crea una Task quando servono retry, osservabilità, fan-out/fan-in o un effetto esterno separato. I parametri motore appartengono a settings.

Validare con Job Builder

Lo studio controlla cicli e dipendenze localmente e genera il body esatto di POST /v1/jobs. POST /v1/jobs/validate resta autorevole per capabilities, settings, quote e account.