集成配置
Webhook 配置指南
把 Pingworth 的事件实时推送到你自己的服务端点。
Webhook 让你在事件发生时立即收到通知，无需轮询接口。
创建 Webhook
- 进入「集成中心 → Webhook」
- 点击「新建端点」，填写接收地址（必须是 HTTPS）
- 勾选需要订阅的事件类型
- 保存后会生成一个签名密钥，请妥善保管
事件类型
| 事件 | 触发时机 |
|---|---|
report.completed | 报表生成完成 |
alert.triggered | 告警被触发 |
member.invited | 新成员被邀请 |
验证签名
每个请求头都会带上 X-Pingworth-Signature，请按下面的方式校验：
import crypto from 'node:crypto';
function verify(rawBody, signature, secret) {
const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}校验失败的请求应当直接丢弃。