不再害怕 Webhook 和 API

迟早有一天，工作流需要一项可视化工具里没有现成模块的功能。这时你就会接触到 API 和 Webhook。两者都比人们想象的简单。

比喻

• API 就像一个你走过去的柜台。你提出请求（“给我客户 42 的未结发票”），等待，然后拿到答复。
• Webhook 就像一位送货司机。你把自己的地址告诉某个服务，每当有事情发生时，它就会把包裹送到你门口（“发票 1071 已付款”）。

API 用来主动询问，Webhook 用来被动通知。

从工作流调用 API

大多数工作流工具都有一个“HTTP 请求”步骤。其中四个字段最为关键：

响应同样以 JSON 返回。你的工具会允许你从中挑选字段，供下一步使用。

接收 Webhook

在你的工具中创建一个“Webhook 触发器”，它会给你一个 URL。把这个 URL 粘贴到另一个服务的“通知我”设置中。从那时起，每个事件都会启动你的工作流，并把事件数据作为输入。

两条规则：

• 验证发送方。 大多数服务会对 Webhook 签名。你的工具通常有一个检查签名的开关；请把它打开。
• 预期会有重复。 服务在没有收到回应时会重试。让工作流能安全地用同一事件重复运行（在采取行动之前，先检查“事件 1071 我是否已经处理过？”）。

调用任何东西之前

• [ ] 我知道这次调用是读取数据还是修改数据。
• [ ] 令牌已存储为密钥。
• [ ] 我已经手动试过一次这个调用（大多数文档都有“试一试”按钮）。
• [ ] 我知道速率限制，以及超出限制时会发生什么。

动手试试

挑一个你已经在付费使用的服务，找到它的 API 文档页面。在你的工作流工具中执行一次 GET 调用，并打印结果。第一次成功的调用，就能消除大部分的恐惧。