ConverterHQDevelopers
API v1

Webhooks

Eventi firmati con retry, storico consegne e replay.

I webhook sono il canale push durevole e usano lo stesso flusso di eventi canonico delle altre integrazioni.

Sottoscrivere eventi

Seleziona solo gli eventi Job e Task necessari per evitare traffico inutile.

Verificare firme

Valida ConverterHQ-Signature con body grezzo, timestamp e HMAC-SHA256 e rifiuta timestamp fuori dalla finestra anti-replay.

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

Retry e replay

La consegna è almeno una volta con backoff e storico risposte. Le consegne fallite possono essere ispezionate e riprodotte dalla console.