ConverterHQDevelopers
API v1

Webhooks

Recevez des événements signés avec retries, historique de livraison et replay.

Les webhooks sont le mécanisme push durable de ConverterHQ et utilisent le même flux d’événements canonique que les autres intégrations.

S’abonner aux événements

Choisissez les événements de Job et Task dont votre endpoint a besoin afin d’éviter un trafic inutile.

Vérifier les signatures

Validez l’en-tête ConverterHQ-Signature avec le corps brut, le timestamp et HMAC-SHA256, puis refusez les timestamps hors de la fenêtre anti-rejeu.

Vérification du webhook
event = client.webhooks.verify(
    body=request.body,
    signature=request.headers["ConverterHQ-Signature"],
)

Retries et replay

Les livraisons sont au moins une fois, avec backoff et historique des réponses. La console permet d’inspecter et de rejouer une livraison échouée.