L’application Zapier utilise OAuth et les mêmes API REST, capacités et webhooks que les intégrations personnalisées.
Authentification
Connectez le compte par OAuth HQTools. Les grants sont limités par scope et révocables; l’action de conversion inclut le scope File write car une conversion simple crée d’abord un File d’entrée détenu.
Actions
Convertissez un File, créez ou gérez des Jobs, exécutez des Workflows, estimez des conversions et générez des URLs signées. Les champs dynamiques proviennent du graphe de capabilities.
Déclencheurs instantanés
Les réussites et échecs de Job ou conversion sont livrés par le système de webhooks durable. La livraison est au moins une fois; dédupliquez les effets sensibles.
Données de Workflow
Run Workflow accepte variables validées, metadata et client_reference_id. Mappez l’identifiant stable de l’événement source dans business_event_id : ConverterHQ le transforme en clé d’idempotence afin qu’un retry de transport réutilise le run prévu tandis qu’un nouvel événement crée un nouveau travail.
Exploitation d’un Zap
Convert a File retente une conversion encore en cours avec la même identité business_event_id au lieu d’envoyer un résultat incomplet à l’étape suivante. Pour les workflows longs et le fan-out, utilisez de préférence le trigger webhook de fin avant les étapes en aval.