Проверяйте доставку веб-хуков и устраняйте ошибки.

Прочитайте журнал доставки конечной точки веб-перехватчика Notiondesk, разберитесь с повторными попытками и приостановками, возобновите работу приостановленной конечной точки и исправьте неудачные доставки.

1 мин чтения

Каждая конечная точка ведет журнал запросов, отправленных ей Notiondesk. Используйте его, чтобы узнать, что получил ваш сервер, почему запрос не удался и когда будет предпринята повторная попытка.

Быстрый путь: перейдите в Настройки > Разработчики > Веб-хуки , откройте конечную точку и прокрутите до раздела «Последние доставки» . Щелкните по строке, чтобы увидеть ответ и тело запроса.

Читать о последних поставках

  1. Перейдите в Настройки > Разработчики > Веб-перехватчики .
  1. Нажмите на конечную точку.
  1. Прокрутите вниз до раздела "Недавние доставки" .

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

Икона Статус Что это значит
Зелёная галочка Доставленный Ваш сервер ответил кодом состояния 2xx
Оранжевые часы В ожидании Ещё не отправлено или ожидается следующая попытка. В случае неудачной попытки отображается результат с последующим сообщением о повторной попытке , например, 503, повторная попытка.
Красный Крест Неуспешный Все попытки провалились. В строке отображается последний результат.
Серый минус Отменено Отправка не состоялась, потому что конечная точка была приостановлена ​​или выключена, либо ее центр поддержки больше не мог получать события до следующей попытки.

Открыть доставку

Щелкните по строке, чтобы открыть ее:

  • Идентификатор доставки : то же значение, что и в заголовке X-ND-Delivery, поэтому вы сможете найти запрос в логах вашего сервера.
  • Ответ : код состояния или причина сбоя, время, затраченное сервером, и количество попыток подключения.
  • Тело запроса : точный JSON-код, который был отправлен. Нажмите «Копировать» , чтобы скопировать его.

Содержимое ответов не сохраняется. Для событий, содержащих персональные данные, таких как сообщения, отзывы, сообщения от коллег и запросы на присоединение, содержимое запроса удаляется после завершения доставки.

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

Доставка считается неудачной, если ваш сервер отвечает любым кодом состояния, кроме 2xx, перенаправляет запрос, не начинает отвечать в течение 5 секунд или занимает более 10 секунд в общей сложности. После этого Notiondesk пытается выполнить запрос снова:

Пытаться Когда
1 Сразу
2 1 минута после первой попытки
3 10 минут после второй попытки
4 1 час после третьей попытки
5 6 часов после четвертой попытки

После 5 неудачных попыток доставка помечается как «Неудачная» . Тестовые события и доставки с пометкой «Подписание не удалось» не повторяются.

Когда происходит много событий одновременно, например, во время масштабной синхронизации, отправка сообщений может задерживаться: обычно на несколько минут, а при медленном ответе сервера — до часа. Сообщения остаются в состоянии «Ожидание» и не отбрасываются.

Когда работа конечной точки приостановлена

Notiondesk приостанавливает работу конечной точки, если после всех попыток было совершено 10 неудачных доставок подряд, и первая из этих неудач произошла не менее 24 часов назад. Тестовые события не учитываются.

Когда работа конечной точки приостановлена:

  • Отображается сообщение «Приостановлено» , и прием событий прекращается. Запланированные ранее попытки отменяются.
  • Владелец рабочего пространства и администраторы получают одно электронное письмо с сообщением «Конечная точка веб-перехватчика приостановлена», содержащее имя конечной точки, ее хост и ссылку на настройки веб-перехватчика.
  • События, произошедшие в период паузы, не отправляются позже.

Вкратце:

  1. Исправьте свой сервер. Причины сбоев в разделе «Недавние поставки» укажут на то, что пошло не так.
  1. Нажмите «Отправить тестовое событие» и убедитесь, что оно отображается как «Доставлено» .
  1. Нажмите «Продолжить» .

Конечная точка снова начинает получать новые события, и счетчик ошибок начинается заново.

Если ваша конечная точка все еще активна, но доставка постоянно завершается с ошибкой, на странице конечной точки отображается предупреждение «Сбой с» с указанием даты первого сбоя, прежде чем она будет приостановлена.

Исправить неудачные доставки

Если ваш сервер ответил, в строке отображается его код состояния. В противном случае отображается причина.

Причина То, что вы видите Что случилось Как это исправить
Статус ошибки Код состояния, например, 500 или 401. Ваш сервер ответил с ошибкой. Проверьте журналы вашего сервера за это время. Убедитесь, что конечная точка принимает запросы POST и что проверка подписи использует правильный секретный ключ.
Перенаправление отклонено Код перенаправления, например, 301 или 302. Ваш сервер перенаправил запрос. Введите конечный URL-адрес в настройках конечной точки.
Адрес заблокирован Адрес заблокирован Ваш домен указывает на частный или внутренний адрес. Направьте домен на общедоступный сервер.
Соединение не удалось. Соединение не удалось. Notiondesk не удалось связаться с вашим сервером Убедитесь, что доменное имя разрешается, TLS-сертификат действителен и порт 443 или 8443 открыт.
Время истекло Время истекло Ваш сервер не начал отвечать в течение 5 секунд или потребовалось более 10 секунд. Сначала ответьте с помощью 200, а затем выполните работу в фоновом режиме.
Подписание не удалось Подписание не удалось Notiondesk не удалось подписать запрос Это наша ошибка, и повторная попытка не выполняется. Отправьте тестовое событие и свяжитесь с нами, если это повторится.

Отправить тестовое событие

Нажмите кнопку «Отправить тестовое событие» на странице конечной точки, чтобы отправить событие ping на эту конечную точку. Оно отобразится вверху списка последних доставок .

  • Тестовое событие отправляется один раз, повторных попыток не требуется.
  • Вы можете отправить его, пока работа конечной точки приостановлена, чтобы проверить исправление перед возобновлением работы.
  • Каждое рабочее пространство может отправлять до 20 тестовых событий в час. При превышении этого количества вы увидите сообщение «Слишком много тестовых событий. Попробуйте позже».

Часто задаваемые вопросы

Могу ли я повторно отправить посылку, доставка которой не удалась?

Нет. Откройте отправление и нажмите «Копировать» , чтобы получить текст запроса, если вам нужно обработать его самостоятельно.

Почему отсутствует текст запроса на доставку?

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

Как долго хранятся доставленные товары?

14 дней. В разделе «Последние поставки» отображаются 100 последних заказов.

Возобновляет ли успешное тестирование работу приостановленной конечной точки?

Нет. Проверяется только ваш сервер. Нажмите «Возобновить» , чтобы снова начать получать события.

Что произойдет с событиями в очереди, если я удалю конечную точку?

Они не отправляются, и журнал доставки конечной точки удаляется вместе с ними.

Связанные статьи

Эта страница была полезной?

Still need help? Ask us