WEBHOOK / LOCAL HANDLER

Webhook-туннель для локальной разработки

Дайте внешнему провайдеру публичный URL HTTP-туннеля, а запросы принимайте и отлаживайте в локальном обработчике.

Запустить маршрут Сначала проверить ограничения →

ROUTE MODELwebhook-tunnel

LOCALlocalhost:3000/webhooksource

FORTUNNELS EDGEHTTP tunnelrelay

PUBLICprovider callback URLdestination

ПРОБЛЕМА

Webhook-провайдер не может вызвать localhost

CONTEXT / 01

Что мешает маршруту

Платёжная система, CRM или Git-хостинг отправляет callback только на публичный URL. Локальный обработчик за NAT недоступен для такого запроса.

РЕШЕНИЕ

HTTP-туннель доставляет callback в локальный обработчик

route model

LOCAL  localhost:3000/webhook
  │
  ├── HTTP tunnel
  │
PUBLIC provider callback URL

Запустите туннель к порту приложения и укажите выданный URL в настройках провайдера. Событие можно найти в Traffic Inspector и сопоставить с ответом локального сервиса.

STATIC HTMLNO JS REQUIRED

КОМАНДА

Запуск из терминала

Одна команда создаёт маршрут

CLI выведет фактический публичный адрес или host:port после успешного подключения.

ЛОКАЛЬНОlocalhost:3000/webhook

EDGEHTTP tunnel

ПУБЛИЧНОprovider callback URL

COMMANDfortunnels http 3000

СЦЕНАРИИ

Когда использовать этот маршрут

USE / 01

Сценарий 1

Отладить подпись и заголовки webhook-провайдера.

USE / 02

Сценарий 2

Проверить обработку успешного и ошибочного ответа локального API.

USE / 03

Сценарий 3

Тестировать callback без промежуточного деплоя на staging.

ОГРАНИЧЕНИЯ

Что проверить до запуска

LIMIT / 01

Условие 1

CLI и локальный обработчик должны быть подключены во время доставки.

LIMIT / 02

Условие 2

Повторные попытки и таймауты определяет внешний провайдер; учитывайте побочные эффекты.

LIMIT / 03

Условие 3

Полные тела видны только когда тариф и настройки разрешают их захват.

FAQ

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

Какой URL указать у провайдера?

Используйте публичный URL, выданный CLI, и добавьте нужный путь обработчика, например /webhook.

Можно ли увидеть входящий запрос?

Traffic Inspector показывает событие и доступные по политике захвата данные. Полное тело может быть выключено, обрезано или замаскировано.

Что будет, если локальный сервер выключен?

Туннель не сможет доставить запрос приложению. Поведение повторной отправки зависит от webhook-провайдера.

START / VERIFY

Проверьте маршрут на своём сервисе

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

Скачать CLI Открыть документацию →