跳转到内容
ReigniterDocs
返回网站

Webhook

Webhook 会告诉另一个工具你的 Reigniter 账户发生了某些事情。当事件发生时, Reigniter 会向你选择的地址发送一份签名的 JSON 消息。这个地址可以是自动化的 webhook 触发器、其他工作流程工具,或者你自己的服务器。

Webhooks页面上的活动订阅列表
添加订阅后,每个活动都会发送到你签署的地址 JSON。
事件 应用中的标签 发送时间
video.completed 视频完成 视频渲染结束。消息附带一个下载链接,可使用7天。
video.failed 视频失败 视频渲染失败。
training.completed 学习者完成了一个模块 一名被指定的学习者完成一个模块,并附上他们的分数以及是否通过。
training.overdue 学习者逾期 学员未按时完成作业。

完整列表在 Webhooks 中。在自动化中你不需要 webhook: Reigniter 触发器(视频已完成、 学习者通过、其他)会自动注册。

  1. 开放连接器>Webhook。

  2. 选择 添加。

  3. 选择赛事。

  4. 粘贴应该接收的地址。必须是公共网络地址。私有网络上的地址被拒绝。

  5. 选择 添加。

  6. 复制 签署秘密 并存放在安全的地方。它只显示一次。然后选择 完成。

选择webhook上的测试按钮发送签名测试消息。检查邮件是否到达你的地址。

每条消息都用你的签名秘密签名。你的接收工具应该在信任消息前检查签名,这样别人就无法向它发送假事件。如何检查签名的方法在 API webhooks指南中有介绍。

每条消息还带有一个投递ID,重试时保持不变。用它来忽略重复的消息。

列表中的每个 webhook 都有按钮:

  • 暂停 它。它显示 暂停 , 直到你继续 之前什么都没有收到。
  • 删掉 它。
  • Reigniter 会多次重试一次失败的投递。
  • webhook 显示连续送达失败的次数,例如 失败了 3 次。成功送达会重置计数。
  • 连续多次失败后,webhook会自动暂停。先修复地址,然后继续。
  • 失败的webhook不会影响你的渲染。

Webhooks会从Reigniter发送事件。要用其他工具制作视频,请使用API键。参见“构建自动化”或“API 快速入门”。