SuperAPI AI 工具集

integration-patterns-mastery

编程与开发

查看项目

更新于 10-15 21:46

技能介绍

用途:该技能用于设计和讲解生产环境中与外部 API 的健壮集成,适合需要处理 webhook、重试、数据同步或第三方支付的开发场景。

主要能力:提供集成决策框架,先按 PUSH(webhook、事件)、PULL(轮询、拉取)、BIDIRECCIONAL(双向同步)分类,再确定消息投递保证(at-least-once、at-most-once、exactly-once)与错误处理策略,包括瞬时错误用指数退避重试、永久错误不重试并记录告警、部分失败进入死信队列。内含 webhook 安全处理模式(先验签、幂等检查、处理失败返回 500 触发重试)、带抖动的指数退避重试代码、死信队列写入与告警,以及涵盖安全、可靠性、幂等、可观测性的检查清单。

使用方式:用户提出“设计集成”“安全 webhooks”“重试模式”“同步数据”“集成 Stripe/支付”“解释我的集成”等需求时,分别对应决策框架及 webhook-security.md、retry-patterns.md、sync-strategies.md、payment-edge-cases.md 等参考文件。文中给出 Node.js 示例:webhook 路由、重试封装 retryWithBackoff、isRetryable 判断、死信队列 handleFailedJob。

适用场景:iCal 与 OTA 同步(轮询、对账、冲突解决、重试)、Stripe 集成(客户管理、PaymentIntents、订阅生命周期、关键事件 webhook),以及支付失败催收、争议与拒付、哥伦比亚 COP 无小数货币、防重复扣款等边界处理。

限制:资料未提供安装命令、价格、平台支持与许可信息;内容为西班牙语,且部分描述为个人经验陈述,效果的表述未提供独立验证。