SuperAPI AI 工具集

external-integration-patterns

部署与运维

查看项目

更新于 10-16 03:41

技能介绍

用途:为第三方外部服务集成提供一套可靠性模式,核心原则是外部服务会失败,集成必须可观测、可恢复、失败要显式暴露,避免静默失败。

主要能力:一、快速失败的环境变量校验,在模块加载时而非运行时检查必填变量,并检测首尾空白字符;二、健康检查端点,逐个探测 Stripe、数据库等服务并返回状态、延迟与错误,整体不健康时返回 503;三、结构化错误日志,要求包含 service、operation、userId、error、timestamp 等字段;四、Webhook 可靠性,先验签再处理,处理前记录事件,可落库以便对账,快速返回 200;五、对账定时任务,定期从服务端拉取状态同步本地,作为 Webhook 的兜底;六、支付成功即时拉取,在跳转成功页时主动向服务端核实支付状态并立即授权。

使用方式:在文件路径含 webhook、api/、services/,或代码导入外部 SDK、环境变量引用外部服务、实现第三方 API 集成、审查 Webhook 处理器时触发该技能。资料还给出部署前检查清单与一个 bash 校验脚本 scripts/verify-external-integration.sh,用于检查环境变量与健康端点。

适用场景:Stripe、Clerk、Sendgrid 等第三方服务集成与 Webhook 处理。

限制:资料未提供该技能的安装命令、收费方式与具体平台支持信息;示例代码为示意,实际使用需按项目调整。