ConverterHQDevelopers
API v1

Webhooks

Eventos firmados con reintentos, historial de entrega y replay.

Los webhooks son el canal push durable y usan el mismo flujo de eventos canónico que las demás integraciones.

Suscribirse a eventos

Selecciona solo los eventos de Job y Task que necesite tu endpoint para evitar tráfico innecesario.

Verificar firmas

Valida ConverterHQ-Signature con el cuerpo sin modificar, timestamp y HMAC-SHA256; rechaza timestamps fuera de la ventana anti-replay.

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

Reintentos y replay

La entrega es al menos una vez con backoff e historial de respuestas. La consola permite inspeccionar y repetir entregas fallidas.