SuperAPI AI 工具集

vercel-webhooks-events

部署与运维

查看项目

更新于 10-15 23:30

技能介绍

用途:在 Vercel 项目中搭建 Webhook 端点,接收并处理部署与项目生命周期事件,覆盖集成 Webhook(Vercel Marketplace)与项目级 Deploy Hook。

主要能力:使用 HMAC(sha1)校验 x-vercel-signature 请求头,拒绝缺失或无效签名;按事件类型分发处理,支持 deployment.created、deployment.ready、deployment.error、deployment.canceled、project.created、project.removed、domain.created、integration.configuration.removed;通过事件 ID 记录实现幂等,避免 Vercel 重试导致重复处理;可对接 Slack 发送生产部署成功或失败通知。

使用方式:在 Vercel 控制台 Settings > Webhooks 添加 HTTPS 端点、选择订阅事件并复制密钥(集成 Webhook 在 vercel.com/dashboard/integrations 配置)。服务端用 crypto 模块对原始请求体做 HMAC 校验,校验通过后处理事件并返回 200。本地测试可用 npx localtunnel --port 3000 暴露端口,再用 curl 携带 x-vercel-signature 发送测试负载。

适用场景:部署状态通知、生产发布后触发冒烟测试、失败告警与工单创建、项目与域名变更跟踪。

限制与注意:端点必须公网可访问且为 HTTPS;签名校验需使用原始请求体,密钥须与后台一致;处理耗时过长会返回 504,应尽快返回 200 并异步处理;生产环境幂等存储建议使用 Redis 而非内存集合;通知内容不应包含令牌、环境变量或客户请求数据。具体事件字段与配置细节以 Vercel 官方文档为准。