Внешняя система узнаёт об изменении сразу после события
Доставка событий в ваши сервисы
Подпишите endpoint на нужные события Creodock и получайте проверяемые уведомления об изменениях заказов и других объектов.
Событийная доставка
Внешний сервис получает сообщение после поддерживаемого изменения.
Подпись запроса
Получатель может проверить, что сообщение отправил Creodock.
Повтор доставки
Временная ошибка endpoint не теряет событие сразу.
История попыток
Статус доставки доступен для диагностики.
Рабочая ситуация
Как проходит доставка события
Постоянный опрос API создаёт задержки и лишние запросы. Webhook отправляет событие тогда, когда изменение уже произошло в Creodock.
- 01
Событие
В Creodock меняется поддерживаемый объект.
- 02
Очередь
Сообщение получает отдельную запись для доставки.
- 03
Подписанный запрос
Worker отправляет payload на настроенный HTTPS endpoint.
- 04
Результат
Успех или ошибка сохраняются в истории попыток.
Webhook не замедляет основную операцию
Создание заказа или смена статуса завершаются независимо от доступности внешнего сервиса. Доставка выполняется через очередь, поэтому краткий сбой endpoint не блокирует работу команды.
Повторная доставка требует идемпотентной обработки на стороне получателя. Идентификатор события помогает не применить одно изменение дважды.
Подпись защищает получателя от поддельных запросов
Секрет Webhook хранится на серверной стороне. Получатель вычисляет подпись по исходному телу запроса и сравнивает её до обработки события.
- HTTPS endpoint
- Секрет подписи
- Идентификатор события
- Время отправки
- Статус и число попыток
События принадлежат рабочей области
Подписка получает только события той области, в которой создана. Payload не должен содержать секреты, содержимое файлов или внутренние ошибки платформы.
Без лишних догадок
Частые вопросы
Нужно ли постоянно опрашивать API?
Нет. Webhooks предназначены для доставки событий, а API можно использовать для чтения актуального состояния после получения сообщения.
Как проверить источник запроса?
Сравните подпись запроса с подписью, вычисленной по телу и секрету вашей подписки.
Что будет, если endpoint временно недоступен?
Неуспешная попытка фиксируется, а доставка может быть повторена по политике очереди.
Webhook может получить события чужой области?
Нет. Подписка и событие связаны с одной рабочей областью.
Продолжить знакомство