ConverterHQDevelopers
API v1

Jobs e Tasks

Costruisci DAG di conversione con rami paralleli, retry e tentativi persistenti.

Un Job è un grafo aciclico diretto di Tasks nominate. I rami indipendenti possono eseguire in parallelo e le dipendenze controllano l’ordine.

Modello di esecuzione

Le Tasks import producono Files, convert li trasformano ed export consegna i risultati. Ogni esecuzione fisica resta come TaskAttempt.

Job di esempio

Assegna nomi alle Tasks e riferisci risultati precedenti. ConverterHQ valida dipendenze e cicli prima dell’esecuzione.

Richiesta 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 e fallimenti

Retry infrastrutturali, fallback motore e retry richiesti dall’utente sono distinti; ogni nuovo tentativo conserva lo storico.

Cancellazione

La cancellazione impedisce nuove Tasks, invalida il lavoro in coda e segnala ai worker attivi di terminare i processi e pulire i temporanei.