ConverterHQDevelopers
API v1

Webhooks

Podpisane eventy z retries, historią dostaw i replay.

Webhooks to trwały kanał push i używa tego samego kanonicznego strumienia eventów co inne integracje.

Subskrypcja eventów

Wybierz tylko potrzebne eventy Job i Task, aby ograniczyć zbędny ruch.

Weryfikacja podpisów

Sprawdzaj ConverterHQ-Signature względem surowego body, timestampu i HMAC-SHA256; odrzucaj stare timestampy, aby zapobiegać replay.

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

Retries i replay

Dostawa jest at-least-once z backoffem i historią odpowiedzi. Nieudane delivery można sprawdzić i ponowić w konsoli.