SCHEMA · VALIDATE · GENERATE

在线 JSON Schema 校验与示例生成工具

在语法正确之上继续检查字段类型、必填项和嵌套结构,让接口约定变成可执行规则。

01

什么时候使用

  • 检查接口请求或响应是否符合约定的数据结构
  • 验证必填字段、类型、枚举和嵌套对象约束
  • 从现有 Schema 生成示例 JSON,用于联调和测试

02

操作步骤

  1. 准备待校验 JSON 与对应的 JSON Schema。
  2. 打开 Schema 面板,执行校验并逐条查看失败路径。
  3. 按业务规范修正数据或 Schema,再重新运行校验。

03

结果检查

  • 确认 Schema 草案版本与团队或服务端实现一致。
  • 语法有效的 Schema 仍可能遗漏业务规则,需要评审约束完整性。
  • 生成的示例用于起步,不代表真实或完整的生产数据。

04

输入与预期结果

Schema 可以把“id 必须是整数、name 必须存在”变成可重复执行的检查,而不仅是口头约定。

输入:数据与最小 Schema
数据:{"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、枚举语义和关联关系仍需人工补充。