Webhook
Webhook 是在事件发生时(收到消息、付款完成、状态变化),服务主动向你事先登记的 URL 发送的 HTTP 请求。你的服务器不用反复发请求,而是接收传入的请求。
Webhook 如何工作
你登记一个公网 HTTPS URL;事件发生时,服务向它发送带 JSON 请求体的 POST 请求,你的服务器返回 2xx 状态码。Telegram Bot API 就是这样工作的:调用 setWebhook 之后,机器人的每次更新都会以 HTTPS POST 的形式发到你的 URL。如果返回的不是 2xx,Telegram 会重发请求,并在若干次尝试后停止(Telegram Bot API 文档)。
URL 是公开的,因此需要校验传入的请求。Telegram 会把 secret_token 参数的值放进 X-Telegram-Bot-Api-Secret-Token 头;拒绝不带该头的请求。使用 getUpdates 的轮询与 webhook 不能同时工作:Telegram 只允许一种接收更新的方式。
Webhook 还是轮询:一个例子
假设示例:某事件一天发生 5 次。每 10 秒轮询一次,就是每天 24 × 3,600 ÷ 10 = 8,640 次请求,其中只有 5 次带来新消息。Webhook 在同一天只需 5 次请求,每个事件一次。
作为代价,webhook 需要一台带公网 URL、全天候接收请求的服务器。如果你的服务器宕机的时间超过服务的重试时长,就可能错过事件。
Genesis API 没有 webhook
Genesis API 只在被请求时提供数据:每次调用都是 HTTP GET(文档),没有 webhook,也没有 WebSocket。有两种方式可以第一时间获知机会。
不写代码:Telegram 通知。Genesis Arbitrage 会把你所选类别和筛选条件对应的信号发到你自己的 Telegram 机器人。个人机器人包含在网站的 Pro 订阅中,设置方法见指南。
写代码:按套餐的新鲜度轮询 Genesis API(步长见套餐与限额),出现机会时给自己发消息。Python 加密货币套利机器人就是这样工作的。
常见问题
Genesis API 能向 webhook 发送数据吗?
不能,Genesis API 只响应客户端的请求。如果想要现成的提醒而不写自己的代码,请使用 Genesis Arbitrage 的 Telegram 通知。