ConverterHQDevelopers
API v1

Jobs i Tasks

Buduj DAG-i konwersji z równoległymi gałęziami, retries i trwałymi próbami.

Job to skierowany acykliczny graf nazwanych Tasks. Niezależne gałęzie mogą działać równolegle, a dependencies sterują kolejnością.

Model wykonania

Tasks import tworzą Files, convert je przekształca, a export dostarcza wyniki. Każde fizyczne wykonanie jest zapisane jako TaskAttempt.

Przykładowy Job

Nazwij Tasks i odwołuj się do wcześniejszych wyników. ConverterHQ sprawdza zależności i cykle przed uruchomieniem.

Żądanie 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 i błędy

Retry infrastruktury, fallback silnika i retry uruchomiony przez użytkownika są oddzielne; każda nowa próba zachowuje historię.

Anulowanie

Anulowanie blokuje nowe Tasks, unieważnia pracę w kolejce i sygnalizuje aktywnym workerom zakończenie procesów i czyszczenie plików tymczasowych.