用途:作为专注 API 契约校验的 QA 技能,它系统性验证 API 响应是否符合已发布的规范,检查跨版本的向后兼容性,确保消费者预期不被破坏。
主要能力:将 OpenAPI/Swagger 规范与 JSON Schema 视为权威契约,逐字段、状态码与响应头精确比对;默认要求向后兼容,禁止在无显式版本化的情况下删除字段、修改类型或变更响应结构;支持消费者驱动契约测试以贴合真实使用方预期;在 CI 中每次提交即运行,尽早发现契约漂移;对 API 版本、schema 版本与契约版本显式跟踪;校验范围覆盖状态码、响应头、内容类型、错误响应格式、分页结构与空集合等边界情况。资料中给出 Playwright 与 AJV 的实现示例,包含 OpenAPI 响应校验、JSON Schema 校验以及向后兼容性检查(检测删除属性、类型变更、新增必填字段、枚举值移除)。
使用方式:按示例项目结构将契约测试放在 tests/contracts 下,拆分 openapi、json-schema、consumer-driven、graphql 等目录;使用 schema-loader 加载 YAML/JSON 规范,用 Ajv 编译 schema 校验响应。资料未提供具体安装命令。
适用场景:需要保障 API 契约稳定、防止破坏性变更、执行消费者驱动契约测试的团队与项目。
限制:所列代码为示例,实际 API 路径、schema 与配置需按项目替换;GraphQL 部分资料仅列目录结构,未展开细节;未提供收费、平台支持或效果保证等信息。