SuperAPI AI 工具集

webhook-architecture

通用与其它

查看项目

更新于 10-15 21:42

技能介绍

用途:Webhook 是电商平台(Shopify、Stripe 等)通过 HTTP 回调推送实时事件的方式。本技能用于构建可靠的 Webhook 接收端,以及为自建平台实现可靠的发送端,避免事件丢失或重复处理。

主要能力:HMAC 签名验证防止伪造事件;基于事件 ID 的幂等处理容忍重复投递;指数退避重试;死信队列(DLQ)保存重试耗尽的事件并支持重放;发送端采用 Outbox 模式保证至少一次投递。

使用方式:先确定平台与需订阅的事件主题。Shopify 在后台 Settings → Notifications → Webhooks 创建,或通过 Admin API 注册;WooCommerce 在 WooCommerce → Settings → Advanced → Webhooks 配置,也可用 WP Webhooks 插件;BigCommerce 在 Advanced Settings → Legacy API Settings → Webhooks 配置。接收端需用原始请求体计算 HMAC(不要先解析 JSON),校验通过后按事件 ID 去重,先落库标记再异步处理,并立即返回 2xx。发送端在业务事务内写入 outbox 表,由独立轮询器投递,重试间隔为 1min、5min、30min、2hr、8hr,5 次失败后进入死信队列并告警,修复后可重放。

适用场景:接收平台 Webhook、排查漏事件或重复处理、自建平台对外通知、微服务间事件驱动架构、Webhook 扇出。

限制:资料未提供具体收费、价格与平台支持范围等信息;实现细节依赖所选数据库与运行时,需自行适配。