ConverterHQDevelopers
API v1

Webhooks

Event bertanda tangan dengan retry, riwayat delivery, dan replay.

Webhook adalah kanal push persisten ConverterHQ dan menggunakan event stream kanonik yang sama dengan integrasi lain.

Berlangganan event

Pilih hanya event Job dan Task yang dibutuhkan endpoint agar lalu lintas tidak berlebihan.

Verifikasi signature

Validasi ConverterHQ-Signature terhadap raw body, timestamp, dan HMAC-SHA256, lalu tolak timestamp di luar replay window.

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

Retry dan replay

Delivery bersifat at-least-once dengan backoff dan riwayat respons. Delivery gagal dapat diperiksa dan diulang dari console.