Мониторинг доступности push-уведомлений в Seller API
mainImage.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;
- Конкретный тип событий (сообщений), вызвавших задержку или ошибки;
- Технические рекомендации по локализации сбоя.
Пример уведомления:

FAQ: Что делать, если...
1. Что делать, если вебхук был автоматически отключен?
- Проанализируйте логи вашего HTTP-сервера за период инцидента и устраните причины высоких задержек или ошибок.
- Включите отправку вручную в UI (Настройки → Интеграции → Push-уведомления) или отправьте POST-запрос к API: /v1/notification/enable.
- После активации URL перейдет в статус «На проверке» до выполнения очередного ночного теста.
2. Что делать, если URL отключен принудительно?
Если URL был заблокирован вручную сотрудником Ozon (например, из-за создаваемой аномальной нагрузки), повторная активация этого адреса невозможна. Вам необходимо зарегистрировать новый эндпоинт, предварительно устранив технические неполадки.
Где отслеживать метрики доступности
В UI личного кабинета (раздел Push-уведомления) доступны следующие параметры:
- URL: адрес вебхука;
- Статус доступности: текущее состояние (Доступен / Нестабилен / Недоступен / На проверке);
- Причина отключения: причина сброса активности (автоматически / продавцом / принудительно);
- Дата проверки статуса: точное время последней проверки доступности.
При наведении на индикатор статуса всплывает тултип с детализацией ошибки и рекомендациями по ее устранению.

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