ConverterHQDevelopers
API v1

Konwersje synchroniczne i asynchroniczne

Jeden kontrakt dla szybkich i długich zadań.

ConverterHQ używa tego samego Job w obu trybach; zmienia się tylko czas oczekiwania połączenia HTTP.

Nagłówki Prefer

Prefer: wait=N ustawia ograniczone oczekiwanie, a Prefer: respond-async zwraca Job natychmiast.

Prefer
Prefer: wait=20
Prefer: respond-async

Ograniczone oczekiwanie

Jeśli konwersja skończy się w oknie, otrzymasz wynik; w przeciwnym razie API zwróci 202, a Job będzie kontynuowany.

Wzorzec produkcyjny

Długie lub masowe workloady wysyłaj asynchronicznie, a podpisane webhooks traktuj jako trwały sygnał zakończenia.