ConverterHQDevelopers
API v1

Jobs en workflows ontwerpen

Modelleer DAGs, parallelisme en dependencies vóór productie.

Een Job is een directed acyclic graph, geen sequentieel script. Elke benoemde Task definieert operation, input, options en dependencies.

Denk in DAGs

Modelleer onafhankelijke Tasks als sibling branches zodat de scheduler parallel kan uitvoeren. Dependencies drukken alleen echte datavereisten uit.

Paralleliseer onafhankelijk werk

Als één upload PDF, thumbnail en tekst maakt, bouw dan drie branches. Werkelijke concurrency blijft begrensd door plan en fairness.

Taskgrenzen kiezen

Maak een Task voor onafhankelijke retry, observability, fan-out/fan-in of externe side effect. Engineparameters horen in settings.

Valideren met Job Builder

De studio controleert cycles en dependencies lokaal en genereert de exacte POST /v1/jobs body. POST /v1/jobs/validate blijft autoritatief voor capabilities, settings, quota en account.