Справочник

Webhook-доставка

Контракт webhook-доставки, подписи и повторные попытки.

На этой странице

Payload

Webhook получает CloudEvent и технический блок доставки, который помогает связать попытку с правилом.

Payload webhook

{
  "event": {
    "specversion": "1.0",
    "id": "sha256-...",
    "source": "billing",
    "type": "invoice.paid",
    "data": {
      "title": "Оплачен счет"
    }
  },
  "delivery": {
    "attempt": 1,
    "rule_id": "rule_..."
  }
}

Подписи

Webhook-запросы подписываются HMAC-заголовками. Проверяйте подпись до обработки payload и логируйте correlation-id доставки.

Повторные попытки

Временные ошибки переводят доставку в retry. Постоянные ошибки после исчерпания попыток попадают в финальный статус, который виден в журнале.