API 契约测试、Mock 与 Schema 审查工具

把 OpenAPI 转成文档和类型,生成 Mock,校验真实响应,并在一个专题里集中检查 Schema 破坏性变更。

这个专题聚焦 API 在真正上线前的契约检查流程:把规范转成文档和 TypeScript 类型、从载荷生成 Schema、准备 mock 数据与 mock server、校验真实响应,以及判断新版本是否引入了高风险的 breaking change。

专题信息

任务类型
utility
Families
api, openapi, json
工具数
13
子簇
3

为什么需要这个专题

API 契约工作通常不是一个工具就能完成,真实交付里经常要把文档、类型、Mock、Schema 校验和变更审查串起来一起做。
把 Mock 生成、响应校验、版本对比和边界测试放在一起,更适合前端联调、后端发布和第三方接口接入前做一轮完整检查。
专题里配套了 OpenAPI 和 JSON 样例,用户可以先快速试跑文档生成、契约校验和 diff 检查,再迁移到自己的真实规范和响应数据。

精选工具

API Mock Server / 请求模拟器
根据接口描述生成可运行的临时 Mock Server,使用 Redis 存储 1 小时并支持动态响应
JSON模式校验器
验证JSON数据是否符合JSON Schema结构定义
JSON Schema 生成器
从示例 JSON 自动推断 JSON Schema,支持手动调整并验证数据
测试数据生成器
通过字段配置批量生成结构化测试数据,支持 faker 字段、地址、信用卡、身份证、正则规则和导出
JSON Schema 转 Zod Schema 转换器
将标准 JSON Schema 的 JSON/YAML 定义转换为可直接在 TypeScript 项目中使用的 Zod 运行时校验代码,支持嵌套结构、数组、枚举和常见校验规则
OpenAPI 转 TypeScript 类型生成器
将 OpenAPI 或 Swagger 的 JSON/YAML 规范转换为 TypeScript 接口类型、请求参数类型和响应类型,并支持输出格式与命名风格配置
API 文档生成器
从 OpenAPI 或注释生成美观的 API 文档
OpenAPI 变更破坏检测器
对比 OpenAPI 或 GraphQL schema,标记 breaking changes,并生成面向 API 团队的影响报告
API 破坏性变更检测与迁移规划器
对比两份 OpenAPI 3.x schema,识别 breaking changes 并给出影响评级与迁移建议
API 响应契约校验器
将真实 API 响应 JSON 与 OpenAPI 3.x 中声明的 response schema 对照校验
API 响应差异与语义分析器
对比两个 API 响应 JSON,标出字段级差异,并区分真正的功能变更与无害的运行时漂移
API 契约压力测试器
根据 OpenAPI 3.x 规范批量生成边界值测试请求,并可选发送到真实后端以发现契约不一致。
API 契约变异测试器
对 OpenAPI 请求字段做语义变异,并可发送到真实后端以检查防御性校验覆盖率

用 Samples 测试

api, openapi, json

相关专题

常见问题

这个专题能做什么?

你可以把 OpenAPI 转成文档或 TypeScript 类型,从载荷生成 JSON Schema,制作 mock 数据和 mock server,校验真实响应,对比 API 版本,并运行契约导向的 stress 或 mutation 测试。

这个专题适合谁?

适合前后端工程师、QA 团队、平台团队、API 设计者,以及所有需要在版本迭代中保持接口稳定的人。

应该从哪里开始?

如果你手里已经有规范,就先用 OpenAPI 样例;如果只有响应载荷,就先用 JSON 样例。通常先生成文档或 Schema,再继续做响应校验、版本对比和契约测试。