Ключевые факты
- Категория
- 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) или включите автопересылку для подходящих запросов, отфильтрованных по методу или содержимому.
Сценарии использования
Примеры
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".