用途:Hookdeck Event Gateway 是位于 Webhook 提供方(如 Stripe、GitHub、Shopify)与应用之间的 Webhook 代理和持久化消息队列,用于替代自建队列基础设施。它保证事件的接收与排队,并按应用可承受的节奏投递,应用只需处理业务逻辑。
主要能力:保证接收与持久化排队,即使服务宕机或流量激增也不丢事件;投递失败自动重试(最多 50 次,支持线性或指数退避,可配置触发重试的 HTTP 状态码,支持 Retry-After);速率限制与峰值保护(按秒、分、时或并发设置投递上限),部署或故障期间可暂停连接而事件仍被接收排队;按内容、请求头、路径或查询过滤事件,支持扇出路由、传输中变换载荷与去重;完整可观测性,包括请求、事件与投递日志、指标(可导出至 Datadog)、Issue 告警(邮件、Slack、PagerDuty)、单个或批量重放、以及书签。
使用方式:本地开发无需账号,运行 npx hookdeck-cli listen 3000 gateway --path /webhooks 即可获得公网 URL 并转发到本地,同时提供检查和重放请求的 Web UI;也可指向已有处理器,如 npx hookdeck-cli listen 3000 stripe --path /webhooks/stripe。若使用提供方 Webhook 技能,可将 Event Gateway 置于应用前以获取保证投递、重试、监控和重放;Hookdeck 可在网关层校验提供方签名,转发时添加 x-hookdeck-signature 头,校验代码可安装 npx skills add hookdeck/webhook-skills --skill hookdeck-event-gateway-webhooks。完整产品技能安装:npx skills add hookdeck/agent-skills --skill event-gateway。
适用场景:需要保证 Webhook 投递(重试、不丢事件)、正在为 Webhook 处理自建队列、需要调试或重放失败投递、需要保护服务器免受流量峰值、需要在事件到达应用前路由/过滤/变换、需要本地 Webhook 开发与隧道、关注生产环境 Webhook 可靠性的用户。
限制:资料未提供具体收费、价格、平台支持范围或性能指标;实际能力与配置请以官方文档为准。