ConverterHQDevelopers
API v1

Zapier

Automatisez les conversions avec des actions et déclencheurs ConverterHQ officiels.

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.