JSON Schema 生成器
从 JSON 样本推断可编辑的 draft-07 JSON Schema。合并全部数组样本,检查可选字段和混合类型,再复制或下载草稿。
仅在本地推断。最多 200,000 个字符、20,000 个被访问的样本值和 40 层嵌套。不上传,也不自动保存。
使用前请检查草稿。手动修改会原样导出,本工具不校验修改后的内容。
什么是 JSON Schema 生成器
根据观察到的 JSON 结构生成初始 Schema,与使用已有 Schema 校验数据不同。输出采用 draft-07,合并数组中的所有元素,并用 anyOf 表示混合类型。样本无法确定业务规则,将草稿用作数据契约前需自行检查。
使用步骤 JSON Schema 生成器
- 粘贴 JSON 值或载入示例。输入为数组时,生成的 Schema 仍描述数组。
- 按需将每个样本对象都存在的属性设为必填。这只是样本中的观察结果,并不能证明字段必须存在。
- 生成后可编辑草稿,再复制或下载。请另行校验修改后的 Schema。
功能与限制
- 所有 JSON 数字均描述为 number,不猜测整数约束、范围、格式、枚举值或禁止额外属性。
- 合并数组内各对象的属性。空数组的 items 不施加类型约束。仍允许额外属性。
- 输入使用 JSON.parse 解析,重复键按其最后一个值处理。不会输出样本值或数值范围,因此 Schema 不保留数字的原始写法。
本工具在浏览器中处理输入,不会上传数据进行处理。
输入:[{"id":1},{"id":2,"label":"x"}]
启用必填推断后:数组元素包含 id(number)和 label(string),仅 id 必填。常见问题
单个样本能定义完整 Schema 吗?
不能。输出描述已观察到的类型,未出现的情况、允许值和业务约束都需要人工检查。
怎样处理 null 和空数组?
null 是独立类型。混合 null 与其他类型时生成 anyOf 分支。空数组无法提供元素类型信息,因此 items 不受约束。
现有校验器能使用此输出吗?
生成的草稿采用 JSON Schema draft-07。可将它和有代表性的数据复制到校验器。本生成器不校验手动修改。