ConverterHQDevelopers
API v1

Jobs dan Tasks

Bangun DAG konversi dengan cabang paralel, retry, dan attempt yang persisten.

Job adalah directed acyclic graph dari Tasks bernama. Cabang independen berjalan paralel dan dependency mengontrol urutan.

Model eksekusi

Import Tasks menghasilkan Files, convert Tasks mentransformasi, dan export Tasks mengirim hasil. Setiap eksekusi fisik disimpan sebagai TaskAttempt.

Contoh Job

Beri nama pada Tasks dan referensikan hasil sebelumnya. ConverterHQ memvalidasi dependency dan siklus sebelum eksekusi.

Request 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"}}
  }
}

Retry dan kegagalan

Retry infrastruktur, engine fallback, dan retry dari pengguna merupakan konsep terpisah; setiap attempt baru mempertahankan riwayat lama.

Pembatalan

Pembatalan mencegah Tasks baru dijadwalkan, membatalkan antrean, dan memberi sinyal worker aktif untuk menghentikan proses serta membersihkan file temporer.