ConverterHQDevelopers
API v1

Jobs y Tasks

Construye DAGs de conversión con ramas paralelas, reintentos e intentos persistentes.

Un Job es un grafo acíclico dirigido de Tasks con nombre. Las ramas independientes se ejecutan en paralelo y las dependencias controlan el orden.

Modelo de ejecución

Las Tasks de importación producen Files, convert los transforma y export entrega resultados. Cada ejecución física queda como TaskAttempt.

Job de ejemplo

Nombra las Tasks y referencia resultados previos. ConverterHQ valida dependencias y ciclos antes de ejecutar.

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

Reintentos y fallos

Los reintentos de infraestructura, fallback de motor y reintentos solicitados por usuario son distintos. Cada intento nuevo conserva el historial anterior.

Cancelación

Cancelar evita nuevas Tasks, invalida trabajo en cola y señala a workers activos para terminar grupos de procesos y limpiar temporales.