Категории

Отладчик и relay webhook

Создает уникальный URL для приема webhook, показывает запросы, проверяет подписи и позволяет повторно отправлять payload

Примеры результатов

2 Примеры

Сначала перехватить Stripe webhook, потом переслать

Создает уникальный URL, проверяет подпись и позволяет повторно отправить запрос

Webhook dashboard with a unique capture URL, signature validation, and replay controls.
Показать параметры ввода
{ "relayTargetUrl": "https://api.example.com/webhooks/stripe", "signatureSecret": "whsec_test_123", "signatureHeader": "stripe-signature", "autoReplay": false, "methodFilter": "POST", "bodyMustContain": "\"type\":\"invoice.paid\"", "storedRequestLimit": 50 }

Отлаживать GitHub webhook с условным relay

Автоматически пересылает только подходящие push-события и сохраняет полный лог

Webhook dashboard configured for conditional relay, replay, and export.
Показать параметры ввода
{ "relayTargetUrl": "https://api.example.com/webhooks/github", "signatureSecret": "github_secret_value", "signatureHeader": "x-hub-signature-256", "autoReplay": true, "methodFilter": "POST", "bodyMustContain": "\"ref\":\"refs/heads/main\"", "storedRequestLimit": 100 }

Ключевые факты

Категория
Network
Типы входных данных
text, checkbox, select, number
Тип результата
html
Покрытие примерами
4
API доступен
Yes

Обзор

Этот инструмент создает уникальный URL для перехвата, проверки и пересылки webhook-запросов. Он позволяет инспектировать входящие данные, проверять HMAC-подписи и вручную или автоматически перенаправлять (replay) payload на ваш локальный или боевой сервер, что значительно упрощает отладку интеграций со сторонними API.

Когда использовать

  • При разработке и тестировании локальных серверов, когда нужно перехватить и изучить структуру входящих webhook-запросов от сторонних сервисов.
  • Для проверки правильности генерации и валидации HMAC-подписей (например, от Stripe или GitHub) до написания серверного кода.
  • Когда необходимо отфильтровать определенные события по HTTP-методу или содержимому тела запроса и автоматически переслать их на целевой URL.

Как это работает

  • Сгенерируйте уникальный URL для приема запросов и при необходимости укажите целевой адрес для пересылки (relay).
  • Настройте параметры безопасности: укажите секретный ключ и заголовок подписи (например, x-hub-signature-256), чтобы инструмент автоматически проверял валидность запросов.
  • Отправьте webhook на сгенерированный адрес. Инструмент перехватит запрос, отобразит заголовки и тело (payload) в удобном интерфейсе.
  • Используйте функцию ручного повтора (replay) или включите автопересылку для подходящих запросов, отфильтрованных по методу или содержимому.

Сценарии использования

Отладка платежных шлюзов (Stripe, PayPal) с проверкой подписей и повторной отправкой успешных транзакций на локальный сервер.
Мониторинг событий CI/CD (GitHub, GitLab) с фильтрацией push-уведомлений только для определенной ветки.
Временное хранение и инспектирование API-запросов от IoT-устройств или сторонних CRM-систем перед их обработкой.

Примеры

1. Отладка webhook от Stripe

Backend-разработчик
Контекст
Разработчик интегрирует оплату через Stripe и хочет убедиться, что сервер корректно обрабатывает события об успешной оплате.
Проблема
Нужно перехватить событие invoice.paid, проверить подпись Stripe и переслать запрос на локальный сервер.
Как использовать
Укажите URL вашего сервера в relayTargetUrl, введите секрет Stripe в signatureSecret, установите заголовок stripe-signature и добавьте фильтр по телу "type":"invoice.paid".
Пример конфигурации
{
  "relayTargetUrl": "https://api.example.com/webhooks/stripe",
  "signatureSecret": "whsec_test_123",
  "signatureHeader": "stripe-signature",
  "methodFilter": "POST",
  "bodyMustContain": "\"type\":\"invoice.paid\""
}
Результат
Инструмент перехватывает только события об оплате, подтверждает их подлинность и позволяет вручную переслать их на сервер для отладки.

2. Автоматическая пересылка GitHub push-событий

DevOps-инженер
Контекст
Инженер настраивает пайплайн, который должен запускаться только при пуше в ветку main.
Проблема
Необходимо отфильтровать лишние события от GitHub и автоматически пересылать только нужные на сервер сборки.
Как использовать
Включите autoReplay, укажите целевой URL, задайте секрет и заголовок x-hub-signature-256. В поле фильтра тела укажите "ref":"refs/heads/main".
Пример конфигурации
{
  "relayTargetUrl": "https://api.example.com/webhooks/github",
  "signatureSecret": "github_secret_value",
  "signatureHeader": "x-hub-signature-256",
  "autoReplay": true,
  "bodyMustContain": "\"ref\":\"refs/heads/main\""
}
Результат
Все push-события в ветку main автоматически проверяются на подлинность и мгновенно пересылаются на сервер сборки, а остальные игнорируются.

Проверить на примерах

network

Связанные хабы

FAQ

Какие HTTP-методы поддерживаются?

Инструмент принимает любые HTTP-методы. Вы также можете настроить фильтрацию, чтобы обрабатывать только POST, PUT или PATCH запросы.

Как работает проверка подписи?

Инструмент вычисляет HMAC-хэш на основе тела входящего запроса и указанного вами секрета, а затем сравнивает его со значением в заданном HTTP-заголовке.

Сколько запросов сохраняется в истории?

Вы можете настроить лимит хранения от 10 до 200 последних запросов для удобного анализа и повторной отправки.

Можно ли автоматически пересылать запросы на мой сервер?

Да, включив опцию автопересылки (autoReplay), инструмент будет мгновенно отправлять все входящие или отфильтрованные запросы на указанный URL назначения.

Как отфильтровать только нужные события?

Используйте поле «Body должен содержать», чтобы перехватывать или пересылать только те запросы, в которых есть определенная строка, например "type":"invoice.paid".

Документация API

Конечная точка запроса

POST /ru/api/tools/webhook-debugger-relay

Параметры запроса

Имя параметра Тип Обязательно Описание
relayTargetUrl text Нет -
signatureSecret text Нет -
signatureHeader text Нет -
autoReplay checkbox Нет -
methodFilter select Нет -
bodyMustContain text Нет -
storedRequestLimit number Нет -

Формат ответа

{
  "result": "
Processed HTML content
", "error": "Error message (optional)", "message": "Notification message (optional)", "metadata": { "key": "value" } }
HTML: HTML

Документация MCP

Добавьте этот инструмент к конфигурации сервера MCP:

{
  "mcpServers": {
    "elysiatools-webhook-debugger-relay": {
      "name": "webhook-debugger-relay",
      "description": "Создает уникальный URL для приема webhook, показывает запросы, проверяет подписи и позволяет повторно отправлять payload",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=webhook-debugger-relay",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Вы можете объединять несколько инструментов, например: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, максимум 20 инструментов.

Если вы столкнулись с проблемами, пожалуйста, свяжитесь с нами по адресу [email protected]