集成
Webhook
安装 an https endpoint you control
Webhook 渠道会为每条告警向你的 URL POST 一个 JSON 体,并用你只复制一次的密钥签名。信任请求体前请先验证签名。
粘贴到 Claude Code、Cursor 或任何 AI 编程助手中。它包含步骤和代码。在 app.blipit.io 的“API 密钥”页面,同一提示词已填好你的密钥。
1添加渠道
集成 › Webhook:输入 https URL,选择项目范围和要接收的告警。签名密钥(whsec_...)只显示一次:“请立即复制签名密钥。它不会再次显示。”
2验证签名
请求头 x-blipit-signature 是用你的密钥对原始请求体计算的十六进制 HMAC-SHA256。请使用恒定时间比较。
import { createHmac, timingSafeEqual } from "node:crypto";
export function verify(rawBody, header, secret) {
const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
return header.length === expected.length && timingSafeEqual(Buffer.from(header), Buffer.from(expected));
}3读取请求体
问题告警如下所示。type 为 new_issue、regression、security 或 test;security 字段仅在安全告警中出现。
{
"type": "new_issue",
"project": { "id": 12, "name": "shop" },
"issue": { "id": 981, "title": "TypeError: cart is undefined", "url": "https://app.blipit.io/issues/981", "level": "error", "event_count": 1 },
"event": { "release": "2026.09.28", "environment": "production", "platform": "javascript" },
"sent_at": "2026-09-28T09:15:00.000Z"
}须知
- 监控器变化以相同方式发送,type 为 monitor.down 或 monitor.up,通知类为 monitor.slow、monitor.fast 和 monitor.expiring。
- 只接受公网地址上的 https URL;不跟随重定向。保存后使用测试按钮可看到一次 type: test 的送达。
- 请尽快返回 2xx。送达失败会在渠道上显示为错误;Blipit 不会排队稍后重试。
- 新的缺陷报告会发送 type bug_report.new,包含 project 和 reports 列表:id、url、kind、title、page_url、reporter、screenshots、recordings 和 still_uploading。同时到达的多份报告会放在同一个请求体中。
遇到问题?发邮件至 support@blipit.io。每个项目的密钥和项目 id 在 app.blipit.io 的“API 密钥”下。