Make 使用 REST API、webhook 和自身的 HTTP 与 webhook 模块连接 Quire。API 参考中的所有功能都可以使用。
根据 Quire 事件启动场景
- 将 Webhooks 模块中的 Custom webhook 添加为第一个模块,并复制该模块的地址。
- 在 Quire 中打开
/admin/webhooks,选择添加订阅,粘贴地址并选择事件。Quire 的测试事件可以让 Make 获取正文格式:发送测试事件时,请运行一次该模块。 - 执行任何操作前先验证签名。在 webhook 的高级设置中传递标头,然后按照开发者指南的说明,使用订阅密钥,根据
webhook-signature验证{webhook-id}.{webhook-timestamp}.{body}。添加筛选器,使验证失败时场景停止。
从场景调用 Quire
使用 HTTP 模块的 Make a request:
| 字段 | 值 |
|---|---|
| URL | https://acme.quirelms.com/api/v1/<resource> |
| 方法 | 按 API 参考中的说明填写 |
| 标头 | Authorization: Bearer qk_live_...;写入请求还需 Idempotency-Key |
| 正文类型 | 原始数据、JSON |
| 解析响应 | 是 |
请在 /admin/integrations/api-keys 为 Make 单独创建密钥,并只授予场景所需的作用范围。查询列表时,如果 page.has_more 为 true,请继续传入 page.next_cursor 作为 cursor:可使用 Make 的 Repeater 和一个保存游标的 Set variable 模块完成此操作。
如果场景需要以某个人的身份操作,请在 /admin/integrations/oauth-clients 注册 OAuth 客户端,并在 Make 的 HTTP 模块中使用 Make an OAuth 2.0 request。
示例:每周完成情况摘要
- 计划:每周一执行。
- HTTP:
GET /api/v1/course_completions?updated_since=<a week ago>。 - 使用 Iterator 遍历
data,再通过 Aggregator 汇总成表格。 - 通过电子邮件发送表格,或将其发布到其他位置。