SuperAPI AI 工具集

webhook-handler-patterns

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:该技能用于指导实现生产级 Webhook 处理器,核心是遵循正确的处理顺序——先验证签名、再解析负载、最后幂等处理。

主要能力:提供处理器顺序、幂等、错误处理、重试逻辑等参考文档,并包含 Express.js、Next.js App Router、FastAPI/Python 的框架指南与注意事项。

必要用法:验证签名时使用原始请求体,无效请求返回 4xx;验证通过后再解析或构造事件;处理时先检查事件 ID,重复事件返回 2xx。响应码约定:2xx 成功不重试,4xx 客户端错误通常不重试(429 除外),5xx 服务端错误按退避重试,429 限流需延迟重试。幂等清单:提取唯一事件 ID、检查是否已处理、在事务内处理、成功后存储事件 ID、重复事件返回成功。

适用场景:构建 Webhook 基础设施、处理支付/电商/代码托管/邮件/计费等平台回调。

限制:资料未提供具体代码示例、安装命令、收费或平台支持细节;框架指南仅列出 Express、Next.js、FastAPI 三类。