Webhooks

Вебхуки — это HTTP POST-запросы, которые Bazex автоматически отправляет на указанный вами URL при возникновении определённых событий. Это позволяет вашим внешним системам мгновенно реагировать на изменения: новый заказ, обновление товара, низкий остаток и другие.

Создание вебхука

Доступные события

Вы можете подписаться на любую комбинацию следующих событий:

• order.created — создан новый заказ
• order.updated — обновлён статус заказа
• order.completed — заказ завершён
• product.created — создан новый товар
• product.updated — обновлён товар
• inventory.low — остаток товара ниже порога
• review.created — оставлен новый отзыв
• customer.created — зарегистрирован новый клиент

Формат доставки

Каждое уведомление отправляется как HTTP POST с телом в формате JSON. Запрос содержит:

• event — тип события (например, order.created)
• timestamp — время возникновения события (ISO 8601)
• payload — данные события (объект заказа, товара и т.д.)

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

Если ваш endpoint вернул ошибку (статус-код 4xx или 5xx) или не ответил вовремя, Bazex повторит отправку до 5 раз с экспоненциальной задержкой:

• 1-я повторная попытка — через 1 секунду
• 2-я — через 2 секунды
• 3-я — через 4 секунды
• 4-я — через 8 секунд
• 5-я — через 16 секунд

Автоматическое отключение

Если вебхук получил 50 последовательных ошибок в течение 24 часов, он автоматически отключается. Вы получите уведомление и сможете исправить endpoint, после чего вебхук можно включить снова.

Логи доставки

В панели управления доступны логи последних доставок для каждого вебхука. Вы можете просматривать статус-коды ответов, время отклика и тело запроса — это помогает при отладке.

Лимиты по тарифам

• FREE — до 3 вебхуков
• BASIC — до 10 вебхуков
• PRO — до 25 вебхуков
• ENTERPRISE — без ограничений