ConverterHQDevelopers
API v1

Webhooks

Ondertekende events met retries, delivery history en replay.

Webhooks zijn het duurzame pushkanaal en gebruiken dezelfde canonieke eventstream als andere integraties.

Op events abonneren

Kies alleen de Job- en Task-events die je endpoint nodig heeft om onnodig verkeer te vermijden.

Handtekeningen verifiëren

Controleer ConverterHQ-Signature met raw body, timestamp en HMAC-SHA256 en weiger timestamps buiten het anti-replayvenster.

Webhookverificatie
event = client.webhooks.verify(
    body=request.body,
    signature=request.headers["ConverterHQ-Signature"],
)

Retries en replay

Delivery is at-least-once met backoff en response history. Mislukte deliveries zijn inspecteerbaar en opnieuw afspeelbaar.