Web 请求与 Webhook
让网站事件启动机器人,以及让反应向其他服务发起请求。
本页内容
网站可以通知机器人有新申请,机器人也可以向网站查询订单状态。这是两个方向:
| 方向 | 谁发起 | 示例 |
|---|---|---|
| 入站 Webhook | 其他服务通知 GetMyBot,启动反应 | 网站收到申请,机器人通知经理 |
| 出站 Web 请求 | 反应查询其他服务并取得响应 | 机器人查询价格或订单状态 |
Webhook 是一个服务自动通知另一个服务。两者都使用 HTTP,即浏览器访问网站所用的协议。已有的现成连接见集成。
入站 Webhook(触发器)
**入站 Web 请求(webhook)**触发器可通过外部 HTTP 请求启动反应:
- 地址:开启触发器并保存反应后,GetMyBot 会生成该反应专用的 Webhook URL。地址可复制,不能自行修改。
- 密钥令牌:防止其他人通过该地址启动反应。
- 方法:
POST/GET/PUT/ANY。
收到的字段保存在反应的临时数据 ctx 中。例如请求带 order_id,动作中可用 {{ctx.order_id}}。设置后发送一次测试请求,确认反应取得预期字段。
出站 Web 请求(动作)
Web 请求动作可在反应中发送 HTTP 请求,设置:
- 方法
GET、HEAD、OPTIONS、POST、PUT、PATCH或DELETE,以及请求头和 JSON 或文字请求体; - 哪些状态码算成功、超时和重试次数;
- 把响应保存到用户参数或
ctx,并用 JSONPath 指定需要的字段; - 异步执行:机器人不等待响应即可继续,之后可由成功或失败反应处理结果。
加载 URL可把网页文字存入 ctx;查询数据源和写入数据源用于已连接的数据源。见数据源与密钥。
Webhook 集成
经常向同一服务发送数据时,可配置 Webhook 集成,填写 URL 和 HMAC 签名,让接收方验证发送者。见集成。
安全性
入站请求应配置密钥令牌,避免其他人启动反应。平台会阻止出站请求访问内部网络的私有地址(SSRF 防护),响应大小也有限制。