ConverterHQDevelopers
API v1

Webhooks

Signierte Lifecycle-Events mit Retries, Zustellhistorie und Replay.

Webhooks sind der dauerhafte Push-Kanal von ConverterHQ und verwenden denselben kanonischen Eventstrom wie andere Integrationen.

Events abonnieren

Abonnieren Sie nur die benötigten Job- und Task-Ereignisse, um unnötigen Traffic zu vermeiden.

Signaturen prüfen

Prüfen Sie ConverterHQ-Signature gegen Raw Body, Timestamp und HMAC-SHA256 und lehnen Sie alte Timestamps zur Replay-Abwehr ab.

Webhook-Prüfung
event = client.webhooks.verify(
    body=request.body,
    signature=request.headers["ConverterHQ-Signature"],
)

Retries und Replay

Zustellung ist mindestens einmal mit Backoff und Antwortverlauf. Fehlgeschlagene Lieferungen können in der Konsole geprüft und erneut abgespielt werden.