用途:该技能用于指导实现生产级 Webhook 处理器,核心是遵循正确的处理顺序——先验证签名、再解析负载、最后幂等处理。
主要能力:提供处理器顺序、幂等、错误处理、重试逻辑等参考文档,并包含 Express.js、Next.js App Router、FastAPI/Python 的框架指南与注意事项。
必要用法:验证签名时使用原始请求体,无效请求返回 4xx;验证通过后再解析或构造事件;处理时先检查事件 ID,重复事件返回 2xx。响应码约定:2xx 成功不重试,4xx 客户端错误通常不重试(429 除外),5xx 服务端错误按退避重试,429 限流需延迟重试。幂等清单:提取唯一事件 ID、检查是否已处理、在事务内处理、成功后存储事件 ID、重复事件返回成功。
适用场景:构建 Webhook 基础设施、处理支付/电商/代码托管/邮件/计费等平台回调。
限制:资料未提供具体代码示例、安装命令、收费或平台支持细节;框架指南仅列出 Express、Next.js、FastAPI 三类。