用途:为平台设计如何向客户服务器推送事件通知,覆盖事件定义、签名、可靠投递、订阅管理与排障。
主要能力:1) 事件分类与目录,采用 Object-Action 命名(如 invoice.paid),每个事件需有稳定名称、描述与载荷模式;2) 载荷信封与模式版本,需在“元数据放 JSON 体”与“元数据放 HTTP 头”之间明确选择,并选定版本策略(端点绑定 API 版本,或事件类型自身版本化);3) 签名方案,建议采用 Standard Webhooks 规范,使用 webhook-id、webhook-timestamp、webhook-signature 三个头,HMAC-SHA256 对 {id}.{timestamp}.{raw_body} 签名并 base64 编码,带算法前缀;签名含时间戳以支持重放保护(建议容差 5 分钟);密钥加前缀(whsec_ 等)便于识别,支持多签名并存以实现零停机轮换;4) 投递契约,明确至少一次投递、稳定事件 ID 用于去重、默认非严格顺序、通过持久队列与按端点隔离解耦请求路径;重试默认采用约一天跨度的指数退避,可升级为可配置计划加熔断;2xx 视为确认,4xx(除 408/429)直接进死信;5) 订阅生命周期与调试面,包括投递日志、重放、测试事件发送。
使用方式:先澄清是新建还是改造、规模量级、消费者类型、工程投入与合规约束、上线期限,再按七步流程设计。构建与购买需先决策:自建、自托管开源网关或托管发送基础设施,三者各有取舍。
适用场景:平台需要向企业集成方、普通 API 开发者或无代码工作流工具推送事件。
限制:资料未提供具体价格、平台支持范围或效果数据;文中提及的厂商名称仅为引用,非强制要求。