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.