ConverterHQDevelopers
API v1

Zapier

Automatizza conversioni con azioni e trigger Zapier ufficiali.

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.