ConverterHQDevelopers
API v1

Jobs e Tasks

Crie DAGs de conversão com ramos paralelos, retries e histórico de tentativas.

Um Job é um grafo acíclico direcionado de Tasks nomeadas. Ramos independentes rodam em paralelo e dependências controlam a ordem.

Modelo de execução

Tasks de import produzem Files, convert transforma e export entrega resultados. Cada execução física permanece como TaskAttempt.

Exemplo de Job

Nomeie Tasks e referencie resultados anteriores. O ConverterHQ valida dependências e ciclos antes da execução.

Requisição de 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"}}
  }
}

Retries e falhas

Retries de infraestrutura, fallback de engine e retries solicitados pelo usuário são separados; cada nova tentativa preserva o histórico.

Cancelamento

Cancelar impede novas Tasks, invalida trabalho na fila e sinaliza workers ativos para encerrar grupos de processos e limpar temporários.