SCHEMA · VALIDATE · GENERATE
在线 JSON Schema 校验与示例生成工具
在语法正确之上继续检查字段类型、必填项和嵌套结构,让接口约定变成可执行规则。
01
什么时候使用
- 检查接口请求或响应是否符合约定的数据结构
- 验证必填字段、类型、枚举和嵌套对象约束
- 从现有 Schema 生成示例 JSON,用于联调和测试
02
操作步骤
- 准备待校验 JSON 与对应的 JSON Schema。
- 打开 Schema 面板,执行校验并逐条查看失败路径。
- 按业务规范修正数据或 Schema,再重新运行校验。
03
结果检查
- 确认 Schema 草案版本与团队或服务端实现一致。
- 语法有效的 Schema 仍可能遗漏业务规则,需要评审约束完整性。
- 生成的示例用于起步,不代表真实或完整的生产数据。
04
输入与预期结果
Schema 可以把“id 必须是整数、name 必须存在”变成可重复执行的检查,而不仅是口头约定。
数据:{"id":"7"}
Schema:{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"name":{"type":"string"}}}
$.id 应为 integer,实际为 string
$ 缺少必填字段 name
05
常见问题排查
先确认输入、所选工具和预期结果,再按下面的任务边界逐项排查。
- 合法数据被判失败
- 核对 Schema 草案版本、format 支持和数字/字符串类型,避免把 "7" 当成整数 7。
- 错误信息太多
- 从最外层 type 和 required 开始修复;上层结构错误常会连带产生多条子字段错误。
- 生成示例缺少真实值
- 示例只根据约束构造占位数据,业务 ID、枚举语义和关联关系仍需人工补充。