SuperAPI AI 工具集

pylon-webhooks

测试与质量

查看项目

更新于 10-15 22:14

技能介绍

用途:帮助开发者搭建 Pylon Webhook 接收端并校验签名。Pylon 是 B2B 客服平台,会向配置的目标地址投递 Webhook,使用 HMAC-SHA256 签名,且没有官方 SDK,需在各框架中手动验证。

主要能力:处理如何接收 Pylon Webhook、如何校验签名、签名校验失败排查,以及 issue.created、issue.updated 等事件的处理。每次投递包含三个请求头:Pylon-Webhook-Signature(hs256= 前缀加十六进制摘要)、Pylon-Webhook-Timestamp(Unix 秒,参与签名内容)、Pylon-Webhook-Version(负载模式版本)。签名内容为 timestamp + "." + rawBody,用目标地址的密钥(创建时仅显示一次)计算 HMAC-SHA256,加 hs256= 前缀后用恒定时间比较。必须对原始请求体校验,不能先 JSON.parse。资料给出 Node(node:crypto)与 Python(hmac)的无依赖校验示例,完整处理器见 examples/express、examples/nextjs、examples/fastapi。

使用方式:设置环境变量 PYLON_WEBHOOK_SECRET。本地开发可用 npx hookdeck-cli listen 3000 pylon --path /webhooks/pylon 启动隧道。事件类型从负载字段(event_type / type)读取,未知类型回退为日志记录。

限制:事件名称仅为示例,并非官方文档目录,规范事件类型列表需登录账号查看,issue.created 与 issue.updated 已知存在但确切格式未公开确认,硬编码前需对照自身目标配置核实。旧版 X-Pylon-Signature 头(仅对原始体做十六进制 HMAC-SHA256,无时间戳与前缀)视为遗留方案,仅在目标早于当前格式时回退使用。建议配合 webhook-handler-patterns 技能处理幂等、错误与重试。