JSON Schema 与 API 契约校验工具

目标与适用范围

在一个专题中比较 JSON Schema 校验、OpenAPI 响应检查、变异测试、压力测试和破坏性变更检测工具，适合 API 契约审查流程。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 开始前准备一份有代表性的输入、文件、数值或示例。

• 明确目标输出格式、使用对象或下游用途。

• 决策点: 应该先走哪条路径？. 选择最符合当前瓶颈的步骤，并把得到的输出保留为下一阶段的输入。

按步骤完成工作流

1. 准备输入并选择路径

使用本阶段选定的工具，保留中间输出；确认结果能服务下一步后再继续。 使用 json-schema-validator, api-response-contract-validator.

2. 执行核心处理

使用本阶段选定的工具，保留中间输出；确认结果能服务下一步后再继续。 使用 api-contract-stress-tester, api-contract-mutation-tester.

3. 复核并交付结果

使用本阶段选定的工具，保留中间输出；确认结果能服务下一步后再继续。 使用 api-breaking-changes-detector-migration-planner, api-response-diff-semantic-analyzer.

交付前验收结果

• 最终输出符合预期格式或决策目标。
• 通过复核、对比或重复运行，确认结果可供下游使用。

常见问题

• 在这个专题里能做什么？ 你可以用 Schema 校验 JSON，让真实响应对照 OpenAPI 契约，比较两个响应负载，生成变异用例，并检测 API 的破坏性变化。
• 这个专题适合谁？ 它适合后端开发者、QA 工程师、API 平台团队、集成方，以及所有需要长期维持 JSON API 兼容性的人。
• 应该如何开始？ 先从单个负载的 Schema 或响应校验开始；如果准备发布版本，再继续看变异测试、压力用例和破坏性变更审查。