Вопросы и ответы о приёме вебхуков

Коротко о том, как устроен сервис: приём, хранение, ответы по правилам, туннель и оплата. Если ответа нет, напишите в поддержку.

Нужна ли регистрация?

Нет. Адрес создаётся сразу и закрепляется за браузером. Аккаунт нужен, чтобы адрес не потерялся при смене браузера, для платных тарифов, туннеля на localhost, CLI, MCP, API-токенов и уведомлений. Бесплатный аккаунт тоже подойдёт.

Где хранятся данные?

На сервере в России. Ленту адреса в аккаунте видят только участники аккаунта. Ленту адреса без регистрации видит любой, у кого есть ссылка, поэтому для рабочих интеграций заведите аккаунт. Условия обработки описаны в документах «Персональные данные» и «Оферта».

Сколько живут запросы?

Срок хранения задаёт тариф, он указан на странице «Тарифы» и в кабинете. Запросы старше срока удаляются автоматически вместе с телом. Адрес без регистрации, которым долго не пользуются, удаляется целиком.

Можно отвечать по-разному, в зависимости от запроса?

Да. Правило проверяет метод, путь, заголовки, параметры, тело, поле JSON, формы или XML, IP отправителя или подпись провайдера и отдаёт нужный код, заголовки и тело. Ещё правило может задержать ответ, переслать запрос на ваш сервер, отправить копию или оборвать соединение.

Как оплатить?

Картой российского банка в рублях, на странице «Тарифы» или в кабинете. Платить можно помесячно или сразу за год, за год дешевле. Автопродление включается только с вашего согласия и выключается в кабинете.

Есть ли туннель на бесплатном тарифе?

Да. Для туннеля нужен вход в аккаунт: CLI подключается по его токену. Сколько туннелей можно держать открытыми одновременно, задаёт тариф.

Куда обратиться, если что-то не работает?

Напишите в поддержку из кабинета или со страницы «Поддержка», входить для этого не нужно. Ответ придёт на почту.

Как проверить вебхук?

Откройте свой адрес на главной и укажите его в настройках сервиса, который шлёт вебхуки. Каждый запрос сразу появится в ленте: метод, путь, заголовки, параметры и тело. Если отправитель ждёт определённый ответ, задайте его правилом: код, заголовки и тело.

Вебхук не приходит. Как понять, где ошибка?

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

Чем заменить webhook.site?

Здесь то же самое: адрес без регистрации, лента запросов, ответы по правилам, выгрузка истории в HAR и JSON Lines. Оплата российской картой в рублях, сервер и данные в России. Туннель на localhost есть и на бесплатном тарифе, нужен только вход в аккаунт.

ngrok не работает в России. Чем заменить?

С российских адресов клиент ngrok получает ошибку ERR_NGROK_9040: по документации ngrok компания не обслуживает страны под санкциями США. Если ngrok нужен для вебхуков, подойдёт наш туннель: запрос приходит в сервис на вашем компьютере, его ответ уходит отправителю, и оба видны в ленте. Как поставить CLI, описано на странице «Туннель».

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

Да. Пока туннель подключён, на запрос отвечает ваш сервис: его код, заголовки и тело уходят отправителю, а в ленте видно и запрос, и ответ. Правила адреса в это время не применяются. Если сервис не ответил вовремя (по умолчанию 30 секунд), отправитель получит код 504.

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

Нет. Туннель сделан для вебхуков: он передаёт HTTP-запросы, пришедшие на адрес приёма. Сайт целиком со стилями и картинками, игровой сервер, SSH и WebSocket через него не работают. Для этого нужен туннель общего назначения.

Подойдёт ли адрес для вебхуков бота MAX?

Да. MAX требует HTTPS на порту 443 и сертификат доверенного центра, адрес приёма этому отвечает. Укажите его в подписке бота (метод subscriptions), и события появятся в ленте вместе с заголовком X-Max-Bot-Api-Secret, если вы задали secret. MAX ждёт ответ 200 не дольше 30 секунд. Уведомления о новых запросах тоже можно получать в MAX.

Остались вопросы? Поддержка: обращение можно оставить и без входа. Тарифы и лимиты описаны на странице «Тарифы».

Cookie и Яндекс Метрика

Мы хотим подключить Яндекс Метрику: она ставит cookie и помогает понять, как посетители пользуются сайтом. Метрика заработает, только если вы разрешите. Без неё сервис работает так же. Политика обработки данных