Тестер вебхуков

Тестер вебхуков — это бесплатный клиентский инструмент, предназначенный для разработчиков, работающих с интеграциями вебхуков. Если вам нужно изучить полезную нагрузку от Stripe, проверить подпись GitHub или симулировать POST-запрос на ваш собственный эндпоинт, этот инструмент позволяет изучать полезные нагрузки и проверять подписи в браузере. На наши серверы ничего не отправляется; симулятор запросов отправляет запросы только на указанный вами URL.

Коротко

Тестер вебхуков анализирует содержимое запросов вебхуков, проверяет подписи HMAC-SHA256 и HMAC-SHA1 и отправляет имитационные POST-запросы на введённый URL. Разбор и проверка подписи выполняются в браузере.

Тестер вебхуков: основные возможности

Функция	Что даёт	Подходит для
Анализ содержимого	Вставьте данные JSON, чтобы получить дерево с подсветкой синтаксиса, сворачиваемыми узлами и статистикой.	Просмотр тела вебхука от любого провайдера
Проверка подписи	Введите данные, секрет и полученную подпись, чтобы проверить HMAC-SHA256 или HMAC-SHA1, используемые GitHub, Stripe и Slack.	Отладка причин неудачной проверки подписи
Имитация запроса	Отправьте POST-запрос с пользовательскими заголовками и телом JSON на общедоступный URL, затем просмотрите статус ответа, заголовки и тело.	Проверка собственной конечной точки
Примеры данных	Готовые реалистичные примеры для GitHub, Stripe, Slack, Discord и Twilio можно проверить или использовать как шаблоны.	Настройка интеграции без реальных событий
Обработка в браузере	Разбор данных и вычисление HMAC выполняются в браузере; содержимое и секреты не отправляются на наши серверы.	Проверка данных, содержащих секреты
Копирование результата	Копируйте форматированные данные, вычисленные подписи или созданные команды cURL.	Передача коллеге сведений о неудачном запросе

Что такое вебхук?

Вебхук (также называемый HTTP-коллбэком) — это автоматизированный HTTP POST-запрос, который сервис отправляет вашему приложению при возникновении определенного события. Вместо того чтобы ваше приложение постоянно опрашивало API на предмет обновлений, сервис самостоятельно отправляет данные о событии на настроенный вами URL. Вебхуки обеспечивают работу интеграций в реальном времени для обработки платежей, контроля версий, обмена сообщениями, конвейеров CI/CD и многого другого.

Ключевые особенности

Как использовать этот инструмент

1. Выберите режим: выберите одну из четырех вкладок — Инспектор данных, Проверка подписи, Симулятор запросов или Примеры вебхуков.
2. Введите данные: вставьте данные вебхука, введите подпись для проверки, настройте запрос или выберите пример из популярных сервисов.
3. Выполните действие: нажмите кнопку действия, чтобы проанализировать, проверить, отправить или загрузить выбранные данные.
4. Изучите результаты: изучите древовидный вид данных, результат верификации, детали ответа или отформатированный пример.

Безопасность вебхуков: почему подписи важны

Когда вебхук отправляется через интернет, нет гарантии, что данные пришли именно от того сервиса, от которого вы ожидаете. Злоумышленник может подделать запрос к вашему эндпоинту с вредоносным содержимым. Подписи HMAC решают эту проблему: отправитель вычисляет хэш данных с использованием общего секрета и включает его в заголовок. Ваш сервер заново вычисляет хэш и проверяет его соответствие — если они совпадают, данные подлинны и не изменены.

Популярные заголовки подписей включают X-Hub-Signature-256 (GitHub), Stripe-Signature (Stripe) и X-Slack-Signature (Slack). Наша вкладка «Проверка подписи» позволяет протестировать этот процесс прямо в браузере.

Популярные провайдеры вебхуков

GitHub

GitHub отправляет вебхуки для событий репозитория, таких как push, pull requests, issues, релизы и другие. Подписи используют HMAC-SHA256 с заголовком X-Hub-Signature-256.

Stripe

Stripe отправляет вебхуки о платежных событиях (платежи, подписки, счета). Они используют схему подписи на основе временных меток с заголовком Stripe-Signature, содержащим компоненты t= и v1=.

Slack

Slack отправляет данные о взаимодействиях и подписках на события. Подписи используют HMAC-SHA256 с заголовком X-Slack-Signature и версионную схему подписания (префикс v0:).

Discord

Вебхуки взаимодействий Discord включают подписи Ed25519. Полезная нагрузка содержит данные о взаимодействии для слэш-команд, кнопок и модальных окон.

Twilio

Twilio отправляет обратные вызовы о статусе SMS, голосовых звонков и других событиях связи. Данные обычно кодируются в формате формы с полями, такими как MessageSid, From и Body.

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

Что такое вебхук?

Вебхук — это HTTP-коллбэк, который передает данные в реальном времени из одного приложения в другое при возникновении события. Вместо постоянного опроса API вебхуки автоматически отправляют данные, что эффективно для событийных архитектур.

Как мне проверить подпись вебхука?

Подписи вебхуков проверяются путем вычисления HMAC-хэша данных с использованием секретного ключа и сравнения его с подписью из заголовка. Используйте вкладку «Проверка подписи», чтобы вставить данные, секрет и полученную подпись для сверки.

Безопасны ли мои данные в этом инструменте?

Да. Все процессы происходят полностью в вашем браузере. Никакие данные, секреты или подписи не передаются на наши серверы. Информация остается на вашем компьютере.

Какие сервисы поддерживает этот инструмент?

Вкладка «Примеры вебхуков» содержит данные для GitHub, Stripe, Slack, Discord и Twilio. Инспектор и верификатор работают с любыми JSON-вебхуками от любого поставщика.

Могу ли я отправлять тестовые запросы через этот инструмент?

Да. Вкладка «Симулятор запросов» позволяет отправлять HTTP POST-запросы с заголовками и телом JSON. Учтите, что сервер должен поддерживать CORS для получения ответа браузером.

Дополнительные ресурсы

• Документация GitHub Webhooks
• Руководство по вебхукам Stripe
• Входящие вебхуки Slack