粘贴一条或多条示例 JSON,自动推断出 JSON Schema:合并多条记录判断哪些字段必填、哪些可能为 null,识别 email、日期时间、网址、UUID、IP 等格式以及取值固定的枚举。生成的 Schema 可以直接用于接口文档和数据校验,建议再按业务规则补充取值范围和说明。
type: ["string", "null"] 这种写法,要改成 nullable: true。生成后可以在 JSON Schema 验证器 中校验数据,或用 JSON Schema 生成表单 预览表单;生成 TypeScript 类型请用 JSON 转 TypeScript。
粘贴一条示例 JSON,或者包含多条记录的数组(勾选“顶层数组的每一项作为一条样本”);选择 Schema 版本、必填字段的判断方式,按需开启格式识别、枚举识别、禁止多余字段、示例值和整数小数区分,右侧实时生成 Schema。
粘贴示例 JSON,右侧会自动生成对应的 JSON Schema。
可以判断哪些字段每条都有(必填)、哪些可能为 null,以及字段的取值范围和格式。
2020-12 用 prefixItems 表示元组、用 $defs 代替 definitions,OpenAPI 3.1 使用 2020-12。
可以作为起点,建议补充 description、取值范围和枚举等业务规则。
Schema 根据样本推断,样本越全面越准确;不会推断取值范围、长度等业务约束,需要手动补充。
示例数据只在浏览器本地处理,不会上传。
可选字段被标成了必填,说明所有样本中都有这个字段,增加缺少该字段的样本或把必填方式改为“不设置”。
JSON 对比 · JSON 补丁工具 · JSON Schema 生成表单 · JSON Schema 验证器 · 全部开发工具