Перейти к содержанию

WEBHOOK / TESTING

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

Создайте HTTPS inbox для событий провайдера, отправьте тестовый запрос и изучите его в инспекторе. Для проверки обработчика повторите сохранённый вызов на настроенную цель туннеля.

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

ПРИМЕР ЗАПРОСАPOST
/webhooks/payment
{
  "id": "evt_123",
  "type": "payment.succeeded"
}
  1. 01
    Inboxсохраняет и подтверждаетACK · HTTP 200
  2. 02
    Инспекторпоказывает доступные данные
  3. 03
    Replayручной запрос к цели туннеля
Схема показывает отдельные шаги: Inbox не вызывает локальный обработчик сам по себе.

ТРИ СПОСОБА НАЧАТЬ

Тестирование webhook: приём, тест и повтор

01

Принять реальное событие

Создайте облачный inbox и передайте провайдеру его постоянный HTTPS-адрес. Режим хранения запишет запрос и подтвердит приём.

Открыть Webhook inbox
02

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

Создайте синтетический запрос, чтобы проверить событие и увидеть его в инспекторе без новой отправки от провайдера.

Как отправить тестовое событие
03

Повторить сохранённый запрос

Подключите локальный обработчик к туннелю, задайте цель и отправьте сохранённый HTTP-запрос; затем сравните ответ попытки с исходным событием.

О Replay и сравнении попыток

ПРАКТИЧЕСКИЙ ПОРЯДОК

От запроса к проверенному повтору

Полученный запрос можно изучить в инспекторе; полный захват тела зависит от тарифа и настроек.

  1. 01

    Создайте inbox

    Получите постоянный HTTPS-адрес в личном кабинете и укажите его у провайдера.

  2. 02

    Получите или создайте событие

    Пришлите webhook от провайдера или сформируйте тестовое событие вручную.

  3. 03

    Изучите запрос

    Сверьте метод, путь, ответ и заголовки. Полное тело зависит от тарифа и настройки захвата.

  4. 04

    Повторите и сравните

    Подключите клиент к локальному обработчику и настройте цель туннеля. Затем запустите Replay и сопоставьте ответ попытки с исходным событием.

MOCK RESPONSE

Проверьте ожидаемый ответ провайдера

Mock inbox может вернуть заданный HTTP-статус, заголовки и тело по правилу или fallback — для этого локальное приложение не вызывается.

Mock доступен на платных планах с Webhook inbox; размер тела ответа ограничен возможностью захвата тела на тарифе.

О mock-ответах inbox
Ответ провайдеруПример
HTTP status503 Service Unavailable
{ "status": "maintenance" }

Пример ответа правила, а не результат реального запроса.

ЧТО ВЫ УВИДИТЕ

Данные и границы проверки

  • Инспектор показывает метод, путь, статус, длительность и доступные заголовки запроса и ответа.
  • Webhook inbox в режиме «Только хранение» записывает запрос и возвращает провайдеру HTTP 200; код вашего приложения он не вызывает.
  • Полные тела доступны только при подходящем тарифе и включённом полном захвате; лимит размера может обрезать содержимое.
  • Replay отправляет запрос на настроенную цель туннеля. Повтор может снова выполнить побочные действия в приложении.

FAQ

Частые вопросы

Webhook inbox вызывает мой обработчик?

В режиме «Только хранение» inbox сохраняет событие и отвечает провайдеру HTTP 200. Код приложения не запускается, поэтому этот ACK не показывает ответ обработчика.

Как проверить именно ответ приложения?

Подключите клиент к локальному обработчику и используйте Replay сохранённого HTTP-события на настроенную цель туннеля. Убедитесь, что цель тестовая: повтор может повторить побочные эффекты.

Почему в инспекторе нет полного тела?

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

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

Тестовое событие создаётся вручную и помечается как тестовое. Оно помогает проверить просмотр события без ожидания внешней отправки.

Можно ли вернуть провайдеру mock-ответ?

Да. Настройте правило и fallback в Mock inbox. Возможность доступна на платных планах с Webhook inbox, а тело ответа ограничено условиями захвата.

ГОТОВЫ НАЧАТЬ?

Создайте адрес для следующего webhook

Inbox сохраняет событие и подтверждает его приём. Чтобы проверить обработчик, подключите клиент и запустите Replay на настроенную цель.

Открыть Webhook inbox