1. 查找计算器
  2. 输入数字和单位
  3. 读懂并信赖结果
  4. 保存、分享与嵌入
  5. 使用 API 开发
  6. 账户与套餐
  7. 隐私与你的数据
  8. 解决问题

验证 Webhook 签名

根据 X-CalcLib-Signature 请求头构造字符串 t.body,用你的密钥计算 HMAC-SHA256,并在处理该推送之前先进行比对。

API 令牌、用量、面向 AI 智能体的 MCP 服务器和 Webhook。

在 Webhooks 中添加的 webhook 端点,会在每次有人运行你的嵌入计算器时收到一个已签名的 POST 请求。每次推送都带有 X-CalcLib-Signature 请求头,格式为 t=<unix time>,v1=<signature>。

先验证,再解析

  1. 读取原始请求正文。如果先解析再重新序列化 JSON,字节会发生变化,签名就永远无法匹配。
  2. 从请求头中取出 t,并构造字符串 t.body:时间戳、一个点,然后是原始正文。
  3. 用你的端点密钥对该字符串计算 HMAC-SHA256,结果为十六进制。
  4. 以恒定时间方式将它与每个 v1 值进行比对。在轮换密钥期间,请求头中可能带有两个 v1 值,任何一个匹配即可。
  5. 如果 t 与你的系统时钟相差超过 5 分钟,请拒绝该推送。

推送失败时

系统会在 1 分钟、5 分钟、30 分钟、2 小时和 8 小时后重试。如果某个端点连续失败 20 次,就会被停用,并且我们会给你发邮件,邮件受通知中的产品开关控制。

这篇文章对你有帮助吗?

还是没解决? 联系客服 · 帮助中心