ConverterHQDevelopers
API v1

Webhooks

Retry, teslimat geçmişi ve replay destekli imzalı event'ler.

Webhooks ConverterHQ'nun kalıcı push kanalıdır ve diğer entegrasyonlarla aynı kanonik event akışını kullanır.

Event aboneliği

Gereksiz trafiği önlemek için yalnız gereken Job ve Task event'lerine abone olun.

İmza doğrulama

ConverterHQ-Signature değerini raw body, timestamp ve HMAC-SHA256 ile doğrulayın; replay penceresi dışındaki timestamp'leri reddedin.

Webhook doğrulaması
event = client.webhooks.verify(
    body=request.body,
    signature=request.headers["ConverterHQ-Signature"],
)

Retry ve replay

Teslimat at-least-once, backoff ve cevap geçmişiyle çalışır. Başarısız teslimatlar konsoldan incelenip tekrar oynatılabilir.