Егор Курочкин
Разработка

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

Заголовок
Заголовок

Простыми словами:

Вебхук — это инструмент для обмена данными между различными сервисами.
Простое определение

Немного сложнее:

Вебхук (Webhook) — это механизм, с помощью которого один веб-сервис автоматически отправляет HTTP-запрос вида POST на URL другого сервиса при возникновении определенного события.
Профессиональное определение

Вебхуки широко используются, в том числе в платёжных системах, службах доставки и мессенджерах. Их часто сравнивают с запросами по API, однако принцип действия вебхука отличается.

Отличие от API
Отличие от API

Принцип работы

Вебхук автоматизирует процессы в веб-приложениях следующим образом:

  1. Пользователь оплатил подписку на онлайн кинотеатр
  2. Платёжная система отправляет вебхук на URL онлайн кинотеатра с данными об оплате
  3. Если платёжная система не получила ответ 200 ОК, то вебхук отправляется повторно
  4. Онлайн кинотеатр обрабатывает полученный вебхук: обновляет базу данных и выдаёт пользователю подписку
  5. Пользователь возвращается со страницы оплаты в онлайн кинотеатр и наслаждается просмотром любимых сериалов

Как правило, для уведомлений выбирают формат JSON, так как он компактный и легко читается:

{ "event": "subscription.payment.success", "id": "7f3a9c2b1d4e", "timestamp": "2026-01-29T14:32:18Z", "subscription_id": "sub_4a8b2c6d9e1f", "plan": "premium_monthly", "amount": 199, "currency": "RUB", "customer_id": "cust_1a2b3c4d5e6f", "email": "user@example.com" }

Безопасность

Правила безопасности при работе с вебхуком
Правила безопасности при работе с вебхуком

Чтобы злоумышленники не могли подменить вебхук, перехватить или повторить его, нужно аутентифицировать входящие POST-запросы, зашифровать их и проверить их временную метку. Существует минимальный набор механизмов защиты, которые помогут справиться со всеми наиболее распространенными проблемами.

Подведем итоги

Недостатки вебхука
Недостатки вебхука

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

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

Они часто используются для уведомлений о важных событиях, например, об оплате счета или бронировании билета.

Главное отличие вебхука от API — вебхук срабатывает автоматически при событии, а API требует запроса со стороны клиента.

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

Разработаем IT-решение для вашего бизнеса, переходите на наш сайт