ConverterHQDevelopers
API v1

Jobs und Tasks

Konvertierungs-DAGs mit parallelen Zweigen, Retries und dauerhaften Attempts.

Ein Job ist ein gerichteter azyklischer Graph benannter Tasks. Unabhängige Zweige laufen parallel, Abhängigkeiten steuern die Reihenfolge.

Ausführungsmodell

Import-Tasks erzeugen Files, convert-Tasks transformieren sie und export-Tasks liefern Ergebnisse. Jede physische Ausführung bleibt als TaskAttempt erhalten.

Beispiel-Job

Benennen Sie Tasks und referenzieren Sie vorherige Ergebnisse. ConverterHQ prüft Abhängigkeiten und Zyklen vor der Ausführung.

Job-Anfrage
{
  "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 und Fehler

Infrastruktur-Retries, Engine-Fallback und benutzerinitiierte Retries sind getrennt. Jeder Retry erzeugt einen neuen Attempt statt Historie zu überschreiben.

Abbruch

Abbruch stoppt nachgelagerte Planung, invalidiert wartende Tasks und signalisiert aktiven Workern, Konverterprozesse sauber zu beenden.