ConverterHQDevelopers
API v1

Webhooks

Eventos assinados com retries, histórico de entrega e replay.

Webhooks são o canal push durável e usam o mesmo stream de eventos canônico das demais integrações.

Assinar eventos

Selecione apenas os eventos de Job e Task necessários para evitar tráfego desnecessário.

Verificar assinaturas

Valide ConverterHQ-Signature usando corpo bruto, timestamp e HMAC-SHA256 e rejeite timestamps fora da janela anti-replay.

Verificação do webhook
event = client.webhooks.verify(
    body=request.body,
    signature=request.headers["ConverterHQ-Signature"],
)

Retries e replay

A entrega é pelo menos uma vez, com backoff e histórico de respostas. Falhas podem ser inspecionadas e repetidas no console.