Мониторинг доступности push-уведомлений в Seller API

26 августа 2026
613
5 мин
3
mainImage.pngmainImage.png

В Seller API появилась система автоматического мониторинга доступности webhook-эндпоинтов, на которые отправляются push-уведомления. Теперь платформа непрерывно отслеживает доступность ваших вебхуков, заранее предупреждает о проблемах и защищает инфраструктуру от потери данных. Ниже разбираем, как устроена система мониторинга, как интерпретировать статусы и что сделать для обеспечения высокой доступности сервиса.

Как работает система мониторинга

Задержки в обработке или таймауты на стороне интеграций могут приводить к деградации очереди отправки сообщений. Чтобы минимизировать эти риски, запущен фоновый процесс аналитики доступности URL-адресов.

Каждую ночь система анализирует доступность и присваивает соответствующий статус доступности:

  • Доступен: эндпоинт отвечает штатно, время обработки запросов в пределах целевых.
  • Нестабилен: фиксируется повышение времени ответа, поэтому требуется диагностика на стороне сервера.
  • Недоступен: высокие задержки ответа или ответы с кодами ошибок 5xx/4xx.
  • На проверке: промежуточный статус после валидации, изменения или повторного подключения webhook URL до прохождения ночного теста.

Текущий статус выводится в интерфейсе личного кабинета Ozon Seller, а также доступен программно через метод /v1/notification/list.

Обязательное требование к HTTP-кодам ответов

Сервер продавца обязан всегда возвращать HTTP-статус 200 OK при успешном получении уведомления. Если ваш сервис возвращает ошибки 4xx или 5xx, это расценивается как сбой обработки и также может привести к блокировке отправки push-уведомлений.

Автоматическая защита

Для предотвращения сбоев и переполнения очередей повторных попыток в системе предусмотрен механизм автоматической блокировки URL-адресов:

  • Если URL находится в статусе «Недоступен» в течение 3 дней подряд, система автоматически отключает отправку push-уведомлений на этот эндпоинт.
  • В параметрах подписки флаг активности сбрасывается в состояние disabled, а системный статус отключения меняется на «Отключен автоматически».
  • Отключение не изолирует всю систему: отправка уведомлений на прочие валидные URL-адреса вашей интеграции продолжается без изменений.

Алерттинг и асинхронные уведомления

При переходе эндпоинта в нестабильное или нерабочее состояние генерируется инцидент. Уведомление об изменении статуса автоматически направляется по двум каналам: в чат Seller API в личном кабинете и в специализированный чат Seller API SELLER_API_NOTIFICATIONS.

Уведомление содержит:

  • Идентификатор и адрес проблемного webhook URL;
  • Конкретный тип событий (сообщений), вызвавших задержку или ошибки;
  • Технические рекомендации по локализации сбоя.

Пример уведомления:

image

FAQ: Что делать, если...

1. Что делать, если вебхук был автоматически отключен?

  • Проанализируйте логи вашего HTTP-сервера за период инцидента и устраните причины высоких задержек или ошибок.
  • Включите отправку вручную в UI (Настройки → Интеграции → Push-уведомления) или отправьте POST-запрос к API: /v1/notification/enable.
  • После активации URL перейдет в статус «На проверке» до выполнения очередного ночного теста.

2. Что делать, если URL отключен принудительно?

Если URL был заблокирован вручную сотрудником Ozon (например, из-за создаваемой аномальной нагрузки), повторная активация этого адреса невозможна. Вам необходимо зарегистрировать новый эндпоинт, предварительно устранив технические неполадки.

Где отслеживать метрики доступности

В UI личного кабинета (раздел Push-уведомления) доступны следующие параметры:

  • URL: адрес вебхука;
  • Статус доступности: текущее состояние (Доступен / Нестабилен / Недоступен / На проверке);
  • Причина отключения: причина сброса активности (автоматически / продавцом / принудительно);
  • Дата проверки статуса: точное время последней проверки доступности.

При наведении на индикатор статуса всплывает тултип с детализацией ошибки и рекомендациями по ее устранению.

image

Подробная документация и спецификация API доступна в справочнике.