ConverterHQDevelopers
API v1

Merancang Jobs dan workflows

Modelkan DAG, paralelisme, dan dependency sebelum produksi.

Job adalah directed acyclic graph, bukan script sequential. Setiap Task bernama mendeklarasikan operation, input, options, dan dependency.

Berpikir dalam DAG

Task independen sebaiknya menjadi sibling agar scheduler dapat menjalankannya paralel. Dependencies hanya mewakili prasyarat data nyata.

Paralelkan pekerjaan independen

Jika satu upload menghasilkan PDF, thumbnail, dan text, buat tiga branch. Concurrency tetap dibatasi paket dan fairness scheduler.

Pilih batas Task

Buat Task untuk retry, observability, fan-out/fan-in, atau side effect eksternal yang independen. Parameter engine berada di settings.

Validasi dengan Job Builder

Studio memeriksa cycle dan dependency secara lokal serta menghasilkan body POST /v1/jobs. POST /v1/jobs/validate tetap otoritatif untuk capabilities, settings, quota, dan akun.