Вебхук (webhook) — это автоматическое HTTP-уведомление, которое один сервис отправляет другому в момент наступления события. Как только что-то происходит (пришла заявка, прошла оплата, сменился статус сделки), сервис-источник сам формирует POST-запрос с данными и шлёт его на заранее заданный URL. Не вы спрашиваете «появилось ли что-то новое» — сервис сообщает об этом сам.
Этим вебхук и отличается от API. API работает по опросу (pull): вы периодически дёргаете сервер и проверяете, есть ли свежие данные. Вебхук работает по событию (push): данные приходят сразу, без опроса. Инструменты не взаимозаменяемы — чаще всего они дополняют друг друга.
Обновлено в 2026 году.
- API — вы запрашиваете данные сами, когда нужно; модель pull (опрос, polling).
- Вебхук — данные приходят сами в момент события; модель push (проталкивание).
- Вебхук передаёт данные обычно HTTP-методом POST в формате JSON на ваш URL-обработчик.
- Цепочка работы вебхука: событие → POST-запрос → обработчик.
- Вебхуку нужна защита: HTTPS, подпись запроса секретом и идемпотентная обработка повторных доставок.
Узнать больше о веб-разработке и зерокодинге в целом можно на нашем бесплатном двухдневном марафоне! На встрече мы говорим не только о решениях для создания приложений, но также о заказах, вакансиях и IT-рынке в России.
Что такое API?
API — аббревиатура. Она расшифровывается как application programming interface, или интерфейс программирования приложений. Это своего рода цифровая инфраструктура, созданная для того, чтобы приложения обменивались данными. С технической стороны API — это набор правил и функций, через которые одна программа обращается к другой.
При помощи API разработчики открывают доступ к некоторым функциям своих проектов — чтобы интегрировать их с другими приложениями и автоматизировать работу.
Для примера возьмём Shopify — платформу для управления интернет-магазином. Несмотря на то, что платформа многофункциональная, в неё встроено не всё. Например, у неё нет инструментов для коммуникации команды, фулфилмента и расчётов — эти функции обычно берут на себя сторонние сервисы.
Поэтому разработчикам Shopify нужен был способ быстро связать своё приложение со сторонними ресурсами.
- ПОКАЖЕМ, КАК РАЗВЕРНУТЬ МОДЕЛЬ нейросети DEEPSEEK R1 ПРЯМО НА СВОЁМ КОМПЬЮТЕРЕ
- Где и как применять? Потестируем модель после установки на разных задачах
- Как дообучить модель под себя?
Это решили с помощью API — набора веб-адресов (эндпоинтов), на которые можно слать HTTP-запросы и быстро получать данные.
Сейчас API есть почти у всех крупных сайтов и приложений, но встречаются и те, у кого его нет. Это не страшно. Для таких случаев существуют сервисы вроде Browse AI — мы уже писали о нём.
- ПОКАЖЕМ, КАК РАЗВЕРНУТЬ МОДЕЛЬ нейросети DEEPSEEK R1 ПРЯМО НА СВОЁМ КОМПЬЮТЕРЕ
- Где и как применять? Потестируем модель после установки на разных задачах
- Как дообучить модель под себя?
Что такое вебхук?
Webhook дословно переводится как «веб-перехватчик» или «веб-крючок». С его помощью одно приложение в реальном времени передаёт другому информацию о произошедшем событии. Это своего рода мышеловка, где в роли мыши выступают события: как только на пластину оказывается давление, мышеловка защёлкивается.
Так и с вебхуком: как только происходит онлайн-событие, он срабатывает (активируется) и передаёт данные другому приложению. Технически вебхук — это определённый пользователем обратный HTTP-вызов: при наступлении события источник отправляет пакет данных на специально созданный для этого URL. В качестве данных выступает информация о событии — например, ответы из заполненной онлайн-формы.
Возьмём форму, собранную в зерокодинговом конструкторе Typeform. Допустим, вам нужно собрать данные для исследования. Ответов много, а принимать и сортировать их вручную долго. Здесь и помогут вебхуки: вебхук «слушает» ответы, и как только приходит новый — сразу передаёт его другому приложению, скажем, в таблицу Google Sheets. Всё происходит автоматически.
Вебхуки поддерживают не все приложения: некоторые предлагают только API. Но у большинства современных SaaS-сервисов вебхуки есть — это CRM (amoCRM, Битрикс24), платёжные системы (ЮKassa, Stripe), мессенджеры (Telegram, VK), конструкторы сайтов (Tilda), а также инструменты разработки вроде GitHub.
Как работает вебхук: событие → POST → обработчик
Механика вебхука укладывается в три шага, и понимать её полезно, чтобы корректно настроить приём данных.
- Событие (триггер). В сервисе-источнике что-то происходит: новая заявка, оплата, смена статуса заказа.
- POST-запрос. Источник формирует пакет данных (обычно JSON) и отправляет его HTTP-методом POST на URL, который вы заранее указали в настройках.
- Обработчик. Ваш сервер принимает запрос, разбирает данные и выполняет нужное действие — пишет строку в таблицу, заводит сделку в CRM, шлёт уведомление. В ответ обработчик должен вернуть код 200 OK, иначе источник посчитает доставку неудачной.
Схема ниже показывает этот путь данных от события до вашего обработчика.
Мини-вывод: вебхук — это «обратный звонок» по HTTP. Вам нужно лишь поднять URL, который умеет принимать POST и отвечать 200 OK.
И в чём разница между вебхуком и API?
Допустим, вам всё ещё нужно провести то самое исследование. Собрать данные с формы можно и через API, и через вебхук.
Что сделает API: будет проверять ответы через заданные интервалы — скажем, каждые пять минут. Если в этот промежуток кто-то заполнит форму, API извлечёт ответы и положит их в таблицу. Это и есть опрос (polling).
Что сделает вебхук: сработает в момент, когда кто-то оставит ответ, и сразу перенесёт его в таблицу. Опрашивать сервер каждые пять минут не нужно.
Если свести отличия в таблицу:
| Параметр | API | Вебхук |
|---|---|---|
| Кто инициирует обмен | вы (клиент шлёт запрос) | сервис-источник (по событию) |
| Модель | pull — опрос (polling) | push — проталкивание |
| Когда приходят данные | когда вы спросили | сразу при наступлении события |
| Лишняя нагрузка | холостые запросы «есть ли новое?» | запрос только когда есть событие |
| Объём данных | можно запросить много и выборочно | приходит фиксированный пакет по событию |
| Направление | двустороннее (запрос — ответ) | в одну сторону |
| Когда выбрать | нужно много данных по запросу или история | нужна мгновенная реакция на событие |
Мини-вывод: API — это «спрошу сам, когда понадобится», вебхук — «сообщи мне сразу, как только случится».
Безопасность и надёжность вебхуков
У вебхука есть слабое место: ваш URL-обработчик открыт наружу, а запрос приходит «снаружи». Поэтому при настройке нужно учесть несколько вещей.
- HTTPS. Принимайте вебхуки только по защищённому соединению, чтобы данные нельзя было перехватить.
- Подпись запроса. Серьёзные сервисы подписывают каждый запрос секретным ключом. Например, GitHub считает HMAC-SHA256 от тела запроса с вашим секретом и кладёт результат в заголовок
X-Hub-Signature-256; обработчик пересчитывает подпись и сравнивает — так он убеждается, что запрос действительно от источника, а не от злоумышленника (документация GitHub). - Повторные доставки (retry). Если обработчик не ответил 200 OK или завис, источник обычно повторяет отправку. У GitHub, к примеру, таймаут на ответ — 10 секунд. Из-за повторов одно и то же событие может прийти несколько раз.
- Идемпотентность. Чтобы повторы не задвоили данные, ориентируйтесь на уникальный идентификатор доставки (у GitHub это
X-GitHub-Delivery): уже обработанный ID просто игнорируйте и возвращайте 200 OK.
Проверить и отладить приём вебхука, пока не готов свой сервер, помогают сервисы-перехватчики — например, Webhook.site или RequestBin: они дают временный URL и показывают всё, что на него прилетает.
Мини-вывод: рабочий вебхук — это не только URL, но и проверка подписи плюс защита от дублей.
Вебхук или API — что выбрать для проекта?
Нельзя сказать, что один инструмент лучше другого. Они комплементарны и часто работают вместе. Ориентируйтесь на задачу — на объём, тип данных и требования к скорости.
По времени эффективнее вебхуки: они переносят информацию сразу, как только она появилась. Если для задачи важна скорость реакции — это лучшее решение.
По вариативности данных эффективнее API: через него можно запросить более широкий спектр данных и выбрать именно то, что нужно. Вебхук в этом ограничен — он присылает фиксированный пакет по событию. Зато у API есть свои ограничения: многие сервисы ставят лимиты на частоту запросов (rate limit). Показательный пример — API X (бывший Twitter): в 2023 году бесплатный доступ фактически закрыли, а массовые выборки данных перевели на платные тарифы с жёсткими лимитами. Поэтому приложения, которые тянут много данных через чужой API, упираются в эти потолки.
Смотрите по обстоятельствам. В целом оба инструмента полезны, и уметь обращаться с обоими важно — особенно зерокодеру, который постоянно связывает и интегрирует разные приложения.
Частые вопросы про вебхуки
Что такое вебхук простыми словами?
Это автоматическое уведомление от одного сервиса к другому: при наступлении события источник сам отправляет HTTP-запрос с данными на заданный вами URL. Условно — «не спрашивай меня постоянно, я сам сообщу, когда что-то случится».
Чем вебхук отличается от API?
API работает по опросу (pull): вы сами запрашиваете данные. Вебхук работает по событию (push): данные приходят сами в момент события. API удобен, когда нужно забрать много данных по запросу; вебхук — когда нужна мгновенная реакция.
В каком формате вебхук передаёт данные?
Чаще всего это HTTP-запрос методом POST с телом в формате JSON, который приходит на ваш URL-обработчик.
Вебхуки — это безопасно?
Да, если принимать их по HTTPS и проверять подпись запроса. Сервисы подписывают тело запроса секретным ключом (например, HMAC-SHA256 в заголовке у GitHub), а обработчик сверяет подпись, прежде чем доверять данным.
Что будет, если мой сервер недоступен в момент события?
Большинство сервисов повторяют доставку, если не получили ответ 200 OK. Из-за повторов одно событие может прийти несколько раз, поэтому обработку стоит делать идемпотентной — по уникальному ID доставки.
Какие сервисы поддерживают вебхуки?
Большинство современных SaaS: CRM (amoCRM, Битрикс24), платёжные системы (ЮKassa, Stripe), мессенджеры (Telegram, VK), конструкторы (Tilda, Typeform), инструменты разработки (GitHub).
- ПОКАЖЕМ, КАК РАЗВЕРНУТЬ МОДЕЛЬ нейросети DEEPSEEK R1 ПРЯМО НА СВОЁМ КОМПЬЮТЕРЕ
- Где и как применять? Потестируем модель после установки на разных задачах
- Как дообучить модель под себя?
- Освой нейросеть Perplexity и узнай, как пользоваться функционалом остальных ИИ в одном
- УЧАСТВОВАТЬ ЗА 0 РУБ.
- Расскажем, как получить подписку
- ПОКАЖЕМ, КАК РАЗВЕРНУТЬ МОДЕЛЬ нейросеть DEEPSEEK R1 ПРЯМО НА СВОЁМ КОМПЬЮТЕРЕ
