Вебхуки
Информация о сервисе
Вебхуки — это механизм обратного вызова (callback), позволяющий одной системе (например, банку) отправлять HTTP-запросы с уведомлениями в реальном времени в другую систему (например, вашу) при наступлении определенных событий. В отличие от традиционного взаимодействия, где ваша система выступает клиентом и запрашивает данные, при использовании вебхуков банк сам выступает клиентом и отправляет данные на ваш публичный endpoint.
Схема взаимодействия
Преимущества: снижение нагрузки на серверы, ускорение обмена данными, отсутствие лишних запросов.
Бизнес-кейс: Вы отправили платежное поручение, и время его исполнения неизвестно (например, до 3 часов). Без вебхуков пришлось бы каждые несколько секунд опрашивать API банка "исполнился ли платеж?". С вебхуками Банк сам пришлет уведомление в момент исполнения — вы мгновенно узнаете о событии.
Когда лучше использовать API
- Данные обновляются по расписанию (например, опрос статуса платежей в конце дня)
- Время передачи события не критично
- Запросы статуса нужны только в конкретные моменты
Когда лучше использовать вебхуки
- Важна моментальная передача данных (уведомление об исполнении платежа, поступлении средств)
- Необходимо автоматизировать процессы без задержек
- Вы не знаете, когда произойдет событие, и хотите получать уведомления
Почему вебхуки лучше опроса
Опрос статусов по API — это непрерывные запросы к серверу "есть ли обновления?". Большинство ответов будут "нет", что приводит к пустой трате пропускной способности и вычислительных ресурсов как на вашей стороне, так и на стороне банка.
Вебхуки решают эту проблему: событие доставляется только тогда, когда оно действительно произошло. Это более эффективное решение для уведомлений в реальном времени.