自定义

自定义 webhook

在 Analyse 之上构建任意功能:每个博客事件可作为 JSON 载荷投递到你自己的 HTTP 端点,使用 HMAC-SHA256 签名以便验证来源。

每个博客事件

订阅 blog_post.published、updated、unpublished 和 deleted——每个以带 JSON 正文的 HTTP POST 投递。

HMAC 签名请求

设置签名密钥后,每个请求包含 X-Analyse-Signature 标头——原始正文的 HMAC-SHA256——端点可验证真实性。

多个端点

按需添加任意数量的 webhook 端点,每个拥有独立的 URL、密钥和事件订阅。

工作原理

将 Analyse 指向你的端点,选择事件,并验证签名。

  1. 1

    添加端点

    在 Analyse 中打开集成 → Webhook,输入应接收事件的 URL,以及可选的签名密钥。

  2. 2

    选择事件

    选择投递哪些博客事件——已发布、已更新、已取消发布或已删除。

  3. 3

    验证签名

    使用密钥计算原始请求正文的 HMAC-SHA256,并与 X-Analyse-Signature 标头比较。

  4. 4

    发送测试事件

    投递示例载荷,确认端点正确处理。

常见问题

载荷是什么样的?

Content-Type 为 application/json 的 HTTP POST,包含事件名称、时间戳和文章数据:id、title、slug、excerpt、markdown 正文、特色图片 URL、发布日期、URL 和分类。取消发布和删除事件的正文为 null。

有哪些可用事件?

blog_post.published、blog_post.updated、blog_post.unpublished 和 blog_post.deleted。你可选择每个端点接收哪些事件。

如何验证请求来自 Analyse?

设置签名密钥;每次投递包含 X-Analyse-Signature: sha256=<hex>,即使用密钥对原始正文的 HMAC-SHA256。拒绝不匹配的请求。

基于 Analyse 事件构建

每个博客事件的签名 JSON webhook——连接任意系统。