Вебхук (webhook)
Вебхук (webhook) — HTTP-запрос, который сервис сам отправляет на заранее указанный вами адрес, когда происходит событие: пришло сообщение, прошёл платёж, сменился статус. Вместо повторных запросов ваш сервер принимает входящие.
Как устроен вебхук
Вы регистрируете публичный HTTPS-адрес, сервис при событии отправляет на него POST-запрос с JSON в теле, ваш сервер отвечает кодом 2xx. Так работает Telegram Bot API: после вызова setWebhook каждое обновление бота приходит HTTPS POST-запросом на ваш адрес. Если ответ не из 2xx, Telegram повторяет запрос и после нескольких попыток прекращает (документация Telegram Bot API).
Адрес публичный, поэтому входящие запросы надо проверять. Telegram кладёт значение параметра secret_token в заголовок X-Telegram-Bot-Api-Secret-Token — запросы без него отклоняйте. Опрос через getUpdates и вебхук одновременно не работают: Telegram допускает только один способ получать обновления.
Вебхук или опрос: пример
Условный пример: событие случается 5 раз в сутки. Опрос раз в 10 секунд — это 24 × 3 600 ÷ 10 = 8 640 запросов в сутки, и только 5 из них приносят новость. Вебхук за те же сутки — 5 запросов, по одному на событие.
Взамен вебхук требует сервер с публичным адресом, который принимает запросы круглосуточно. Если сервер был недоступен дольше, чем сервис повторяет доставку, событие можно пропустить.
Вебхуков в Genesis API нет
Genesis API отдаёт данные только по запросу: все вызовы — HTTP GET (документация), вебхуков и WebSocket нет. Узнавать о связках сразу можно двумя путями.
Без кода — уведомления в Telegram: Genesis Arbitrage сам присылает сигналы по выбранным категориям и фильтрам в ваш Telegram-бот. Персональный бот доступен на тарифе Pro подписки сайта, подключение описано в инструкции.
С кодом — опрашивать Genesis API с интервалом свежести тарифа (шаг указан в разделе «Тарифы и лимиты») и отправлять себе сообщение, когда находится связка. Так устроен бот для арбитража криптовалют на Python.
Смотрите также: API, REST API, задержка.
Вопросы и ответы
Можно ли получать данные Genesis API вебхуком?
Нет, Genesis API отвечает только на запросы клиента. Готовые уведомления без своего кода присылают Telegram-уведомления Genesis Arbitrage.