生成的是什么
输出符合 JSON Schema draft-07 规范的描述文件,可以直接用于 API 文档、表单校验、Mock 数据生成,也能喂给前端表单库自动渲染表单。它不是「示例」,而是「约束」:比如样本里 age 是 25,生成的 Schema 会写 type: integer,而不是固定 25。
数组怎么处理
数组会取所有元素的类型做并集。如果元素都是对象,会合并它们的字段,并只把「所有元素都有的字段」列为 required——这样推断更接近真实约束,不会因为某个元素缺字段就判错。
为什么 required 默认全选
单个样本无法判断哪个字段可空。把样本里出现的字段都当必填,是最保守的做法;如果你的接口有可选字段,取消这个勾选后手工调整,或者给样本补一条缺字段的数据做对比。
format 识别的依据
按值的形态匹配:ISO 日期时间、纯日期、邮箱、http(s) 链接、IPv4、UUID。这些是启发式判断,可能与实际语义不符(比如一个订单号恰好长得像 UUID),生成后按需删掉即可。
功能说明
JSON 生成 JSON Schema
手写 Schema 最枯燥:一个接口十几个字段,每个都要写类型、嵌套对象、数组元素,还要判断必填与格式。把真实的接口返回粘进来,结构立刻被推导出来,剩下只需微调业务规则。
能推断出哪些约束
- 类型:string、integer、number、boolean、null、object、array 七种。
- 嵌套结构:对象继续递归,生成 properties 与 required。
- 数组元素:多个元素的类型取并集,对象元素合并字段。
- format:识别 date-time、date、email、uri、ipv4、uuid。
- 示例值:可选把样本值写进 examples,方便看文档的人理解。
它推断不出来的部分
- 取值范围:样本是 25,推不出 minimum 0 maximum 150,需要手写。
- 字符串长度与正则:只能看出是 string,长度与格式规则要自己加。
- 枚举值:看到一个 status 是 active,不能断定只有 active 与 disabled。
- 可选字段:单样本无法判断哪些字段可以缺失。
生成的 Schema 怎么用
可以直接放进 OpenAPI 的 components.schemas 里,也可以用JSON Schema 验证器立刻校验另一份数据是否合规。前端表单库(如 react-jsonschema-form)能直接拿它渲染表单。
使用步骤
1. 在「输入框」中粘贴要处理的内容。
2. 点击「复制」按钮执行。
3. 确认结果无误后,用「复制」保存到本地。
常见问题
JSON生成Schema能做什么?
根据 JSON 样本自动生成 JSON Schema(draft-07):推断类型、嵌套结构、数组元素与 required 字段。全部处理在浏览器本地完成,无需注册、无需安装。
生成的内容能直接用在正式环境吗?
结构可以直接用,工具已经按目标格式组织好了;涉及具体取值、命名、合规表述的部分仍需按你的实际场景逐项确认,不要让默认值直接上线。
会不会有误报或漏报?
会有。自动检测能覆盖的通常是可枚举的显性问题,语义、体验、特殊场景仍需人工判断,建议把结果当线索而不是结论。
检测的内容会上传吗?
不会,比对在浏览器本地完成。涉及未公开的代码或文案时也可以放心粘贴。
你可能还想问
这个工具需要联网才能用吗?
第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。
处理结果怎么保存或分享?
结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。
速查在线工具箱