Эта страница переведена машинным способом. Английская версия является источником и может быть точнее или новее. Открыть на английском

Тестирование вебхуков - Инструменты панели и мониторинг

Панель finlight предоставляет комплексные инструменты тестирования и мониторинга, чтобы ваша интеграция вебхуков работала надёжно. Используйте эти встроенные функции для проверки, тестирования и отладки эндпоинтов вебхуков.

СВОДКА

Сводка функций панели

Ключевые инструменты панели

Список вебхуков:

  • Просмотр всех настроенных вебхуков
  • Просмотр статуса (включён/выключен) с одного взгляда
  • Быстрый доступ к деталям вебхука

Страница деталей вебхука:

  • Вкладка конфигурации - просмотр/изменение настроек вебхука
  • Вкладка истории вызовов - просмотр всех попыток доставки
  • Кнопка тестирования - функция ручного тестирования

Функции истории вызовов:

  • Фильтрация по статусу - показывать только успехи или ошибки
  • Подробные журналы - щёлкните по записям, чтобы увидеть полные данные запроса/ответа
ПАНЕЛЬИнтерфейс управления

Панель деталей вебхука

Откройте интерфейс управления вебхуками на app.finlight.me/news-webhooks, чтобы просматривать и управлять всеми вашими вебхуками.

Доступ к деталям вебхука

  1. Перейдите к списку вебхуков в панели
  2. Нажмите кнопку «Show» вебхука, чтобы открыть страницу его деталей
  3. Просмотрите исчерпывающую информацию о конфигурации и работе вашего вебхука

Страница деталей вебхука предоставляет:

  • Обзор конфигурации - текущие настройки и критерии фильтрации
  • История вызовов - полный журнал всех попыток вебхука
  • Элементы тестирования - функция ручного тестирования
  • Элементы редактирования - ручное редактирование после создания
ТЕСТКнопка тестирования

Ручное тестирование

Функция тестирования вебхука

В панели есть кнопка «Test», которая отправляет образец полезной нагрузки на ваш эндпоинт:

Как использовать:

  1. Откройте страницу деталей вашего вебхука
  2. Нажмите кнопку «Test» на верхней панели
  3. Подождите несколько секунд, пока тестовый запрос завершится
  4. Просмотрите результаты теста в истории вызовов (возможно, обновите страницу)

Что происходит:

  • Отправляет реалистичный образец полезной нагрузки на ваш настроенный эндпоинт
  • Использует ваши реальные настройки аутентификации
  • Включает соответствующие заголовки проверки подписи
  • Записывает попытку теста в вашу историю вызовов

Тестовая полезная нагрузка: Тест отправляет имитированное событие статьи, следующее той же структуре, что и реальные доставки вебхука, что позволяет проверить:

  • Доступность и отклик эндпоинта
  • Конфигурацию аутентификации
  • Логику обработки полезной нагрузки
  • Возможности обработки ошибок
ИСТОРИЯЖурналы доставки

История вызовов и мониторинг

Просмотр истории вызовов

Страница деталей вебхука отображает исчерпывающую историю вызовов со всеми попытками доставки:

Отображаемая информация:

  • Метка времени - когда был отправлен вебхук
  • Статус - успех (2xx) или ошибка (4xx/5xx)
  • Код ответа - код состояния HTTP, возвращённый вашим эндпоинтом
  • Время ответа - сколько времени потребовалось вашему эндпоинту, чтобы ответить
  • Ответ - полный ответ (заголовок и тело) внутри раскрывающегося содержимого по нажатию «Show»

Успешные и неуспешные запросы

Успешные запросы (✅):

  • Коды состояния HTTP 200-299
  • Ответ получен в пределах тайм-аута
  • Надлежащее подтверждение от вашего эндпоинта

Неуспешные запросы (❌):

  • Коды состояния HTTP 400-599
  • Сетевые тайм-ауты или ошибки соединения
  • Сбои аутентификации
  • Недопустимые URL эндпоинтов
ОТЛАДКАУстранение неполадок

Отладка с помощью панели

Использование истории вызовов для отладки

История вызовов — ваш основной инструмент для диагностики проблем вебхука:

Выявление закономерностей:

  1. Фильтровать по статусу - смотрите только неуспешные запросы, чтобы выявить проблемы
  2. Проверять метки времени - ищите временные закономерности в сбоях
  3. Изучать коды ответа - понимайте, что возвращает ваш эндпоинт
  4. Изучать попытки повтора - смотрите, сколько раз была предпринята доставка

Распространённые признаки сбоя:

  • HTTP 401/403 - проблемы аутентификации или авторизации
  • HTTP 404 - неверный URL эндпоинта
  • HTTP 500 - внутренние ошибки сервера в вашем приложении
  • Тайм-ауты - вашему эндпоинту требуется слишком много времени для ответа
  • Ошибки соединения - проблемы сетевого подключения

Подробная информация об ошибке

Щёлкните по любой записи истории вызовов, чтобы увидеть:

  • Полные заголовки запроса, отправленные на ваш эндпоинт
  • Заголовки ответа, полученные от вашего эндпоинта
  • Содержимое тела ответа (если есть)
  • Информацию о точном времени
  • Историю повторов для неуспешных попыток
ТРЕБОВАНИЯРекомендации по реализации

Требования к эндпоинту

Требования к ответу

Ваш эндпоинт вебхука должен:

HTTP-ответ:

  • Возвращать коды состояния 200-299 при успешной обработке
  • Отвечать в пределах 30 секунд, чтобы избежать тайм-аутов
  • Принимать запросы POST с полезной нагрузкой JSON

Заголовки:

  • Обрабатывать X-Webhook-Signature для проверки подписи
  • Обрабатывать X-Webhook-Timestamp для защиты от атак повторного воспроизведения
  • Поддерживать заголовки выбранного метода аутентификации

Рекомендации по настройке вебхуков см. в основной документации по вебхукам. Подробности об аутентификации см. в руководстве по аутентификации.