ConverterHQDevelopers
API v1

Zapier

Automatyzuj konwersje oficjalnymi akcjami i triggerami Zapier.

Aplikacja Zapier używa OAuth i tych samych kontraktów REST, capabilities i webhook co własne integracje.

Uwierzytelnianie

Połącz konto przez OAuth HQTools. Grants są scoped i revocable; action konwersji zawiera File write, bo prosta konwersja najpierw tworzy owned input File.

Actions

Konwertuj Files, twórz i zarządzaj Jobs, uruchamiaj Workflows, estymuj konwersje i twórz signed URLs. Dynamiczne pola pochodzą z capability graph.

Instant triggers

Sukcesy i błędy Job/conversion są dostarczane przez trwały system webhooków. Delivery jest at-least-once; deduplikuj wrażliwe side effects.

Dane Workflow

Run Workflow przyjmuje zwalidowane variables, metadata i client_reference_id. Zmapuj stabilny identyfikator zdarzenia źródłowego do business_event_id. ConverterHQ przekształca tę tożsamość w klucz idempotencji, dzięki czemu retry transportu używa tego samego run, a późniejsze zdarzenie tworzy nową pracę.

Obsługa Zap

Convert a File ponawia konwersję, która nadal trwa, z tym samym business_event_id zamiast przekazywać nieukończony wynik do następnego kroku. Dla długich workflow i fan-out preferowanym punktem granicznym przed kolejnymi krokami jest trigger webhook zakończenia.