SuperAPI AI 工具集

third-party-integration-test

测试与质量

查看项目

更新于 10-15 22:19

技能介绍

用途:为第三方服务集成编写测试,在不访问线上 API 的前提下验证出站调用、入站 webhook、重试与失败处理。

主要能力:先做发现,确认服务与 SDK、可用测试策略(沙箱/测试模式、官方 mock 服务器、无沙箱)、交互类型(出站调用、webhook、轮询、流式)、可能的失败(限流、网络错误、畸形响应、鉴权失败、服务专属错误码)以及密钥处理。策略选择:有沙箱/测试模式(如 Stripe、Twilio、PayPal)用沙箱加 CI 密钥;有官方 mock 服务器(Stripe CLI、Prism)用本地 mock;无沙箱用 msw 或 nock 拦截回放;webhook 用本地拦截器加签名验证;SDK 封装 HTTP 时在 SDK 客户端层 mock,而非 fetch。

关键模式:录制真实响应一次后永久回放,fixture 用原始 API 响应而非裁剪版;断言结构化错误码而非仅“发生错误”;必须测试 webhook 签名验证,拒绝被篡改或缺失签名的载荷;测试幂等键在重试时保持稳定,避免重复扣款;测试限流退避,断言重试次数;对象存储测试键构造、ContentType 与加密等元数据;测试分页游标遍历完整;测试超时与网络失败,确保客户端不挂起。

用法与限制:fixture 按服务、端点、场景命名,提交前清除 PII 与真实密钥,可用 lint 或校验脚本在 CI 中拦截 livemode: true。不要触碰线上生产 API,不要手写 fixture,不要在 SDK 场景下 mock fetch,不要跳过 webhook 签名测试,不要只断言成功路径。输出按交互类型分组,每个用例覆盖一个服务场景并注释 fixture 含义。具体安装命令与代码示例资料中未提供完整内容。