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

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

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

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

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

Вебхуки широко используются, в том числе в платёжных системах, службах доставки и мессенджерах. Их часто сравнивают с запросами по 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 требует запроса со стороны клиента.
🕚У вебхуков есть проблемы: возможная потеря данных при сбоях, уязвимости безопасности и сложности масштабирования при большом объёме событий.

#base #dict