ConverterHQDevelopers
API v1

Jobs en Tasks

Bouw conversie-DAG's met parallelle takken, retries en duurzame attempts.

Een Job is een gerichte acyclische graaf van benoemde Tasks. Onafhankelijke takken kunnen parallel lopen en dependencies sturen de volgorde.

Uitvoeringsmodel

Import-Tasks maken Files, convert-Tasks transformeren ze en export-Tasks leveren resultaten. Elke fysieke uitvoering blijft bewaard als TaskAttempt.

Voorbeeld-Job

Geef Tasks namen en verwijs naar eerdere resultaten. ConverterHQ valideert dependencies en cycli vóór uitvoering.

Job-request
{
  "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 en fouten

Infrastructure retries, engine fallback en door de gebruiker gestarte retries zijn verschillend; elke nieuwe poging behoudt de historie.

Annuleren

Annuleren voorkomt nieuwe Tasks, maakt queued werk ongeldig en signaleert actieve workers om processen en tijdelijke bestanden netjes te stoppen.