L’app Zapier usa OAuth e gli stessi contratti REST, capabilities e webhook delle integrazioni personalizzate.
Autenticazione
Connetti l’account con OAuth HQTools. I grant hanno scope e sono revocabili; l’action di conversione include File write perché la conversione semplice crea prima un File input posseduto.
Azioni
Converti Files, crea/gestisci Jobs, esegui Workflows, stima conversioni e crea signed URL. I campi dinamici provengono dal capability graph.
Trigger istantanei
Successi e fallimenti Job/conversione arrivano dal sistema webhook durevole. La delivery è at-least-once; deduplica gli effetti sensibili.
Dati Workflow
Run Workflow accetta variabili validate, metadata e client_reference_id. Mappa l’ID stabile dell’evento sorgente in business_event_id. ConverterHQ trasforma questa identità nella chiave di idempotenza, così un retry di trasporto riusa il run previsto mentre un evento successivo crea nuovo lavoro.
Gestire uno Zap
Convert a File ritenta una conversione ancora in elaborazione con la stessa identità business_event_id invece di passare un risultato incompleto allo step successivo. Per workflow lunghi e fan-out, il trigger webhook di completamento è il confine preferito prima degli step downstream.