Webhooks
Webhook secret
Read or replace the secret that signs your webhook calls.
POST
Use the secret to check Stophy-Signature on a webhook call: compute the HMAC-SHA256 of “
<t>.<body>” and compare it with v1, then reject a call whose t is more than a few minutes old.
Authorizations
Headers
A value you choose for one call. Send the same key with the same method, path and body within 24 hours and the first answer comes back with idempotent-replayed: true, with the same cost headers and no second charge. A call that sends zeroDataRetention and answers with page data is not kept, so a retry runs again. Needs an API key.