位置: 设置 → 高级 → 连接其他应用
打开此页面: admin.<your-site>/settings/integrations/webhooks(将 <your-site> 替换为您的网站地址)。如果您在菜单中没有看到它,请在“设置”页面中开启 显示所有设置。
开始之前
- 仅网站所有者可以添加 Webhook。
- 接收地址必须以 https:// 开头,且必须位于公网中。
操作步骤
- 打开 设置 → 高级设置 → 连接其他 app → Webhook。
- 点击 添加 Webhook。
- 输入 名称(例如 Zapier)以及 接收消息的地址。
- 在 在以下情况时向我发送消息 下勾选事件:报道已发布、已发布的报道被修改、报道已下线、已添加更正说明、报道已撤回、新评论、订阅变动。
- 点击 添加 Webhook。
- 复制签名密钥。该密钥仅显示一次。然后点击 我已保存。
- 点击 发送测试事件 测试。
温馨提示
- 每条消息都带有签名。请核对“Keynate-Signature”请求头,以确认消息确实来自您的网站。
- 您的系统只需回复任意 2xx 状态码,即表示已收到消息。
- 发送失败的消息会在最多 24 小时内重试。如果 Webhook 连续失败 3 天,系统将自动停用。请修复接收端后点击 恢复。
- 您可以进行 暂停、恢复 或生成 新密钥。旧密钥将在您指定的时间段内继续有效以进行签名。
- 列表中会显示各个 Webhook 的状态:正常运行、尚未使用、未运行、已暂停、已关闭。
- 打开已发送的消息可查看重试记录,并可点击 重新发送。
常见故障
- “地址必须以 https://." 开头”
- “请为该 Webhook 命名。”
- “请至少选择一个事件。”
- “您创建的 Webhook 数量已达上限。请先删除一个不再使用的 Webhook。”
常见问题
常见问题
消息内容是什么样的?
一段简短的 JSON 文本,包含事件类型以及相关的文章信息。
如果我的接收服务器宕机了怎么办?
发送失败的消息会在最多 24 小时内自动重试。