JSON Schema生成器 - 从JSON数据推断结构

JSON Schema

JSON Schema是一种基于JSON格式的声明式语言，用于描述JSON数据的结构、类型和约束规则。它类似于XML Schema（XSD）对于XML的作用，为JSON数据提供了一套标准化的验证和描述机制。Schema本身也是一个合法的JSON对象，通过type、properties、required等关键字来定义数据的规范。JSON Schema广泛应用于API文档生成、数据验证、表单自动生成等场景。

类型推断

类型推断是指根据示例数据的实际值自动确定字段数据类型的过程。例如，当看到一个值为「Hello」的字段时，推断其类型为string；当看到一个值为42的字段时，推断其类型为integer。高级的类型推断还可以识别格式约束，如email格式、日期格式、URI格式等。

Draft-07

JSON Schema的第七个草案版本，发布于2018年。Draft-07是目前最广泛使用的Schema版本，被大多数验证库（如AJV 6.x、jsonschema Python库等）支持。它引入了if/then/else条件验证、contains关键字等特性，是目前生产环境中最成熟和兼容性最好的版本，推荐在多数项目中使用。

2020-12

JSON Schema的最新稳定版本，发布于2020年12月。2020-12版本在Draft-07的基础上引入了多方面的改进，包括prefixItems替代array items的元组验证、新的$defs关键字替代definitions、以及更完善的词汇表机制。它代表了JSON Schema规范的最新发展方向，适合使用最新验证器的项目。

required关键字

JSON Schema中的required关键字用于指定对象中哪些字段是必须存在的。它接受一个字符串数组，数组中的每个元素代表一个必填字段的名称。在数据验证过程中，如果被验证的数据缺少required中指定的任何一个字段，验证器将返回验证失败的结果。required是实现数据完整性约束的重要手段。

additionalProperties

additionalProperties关键字用于控制对象中是否允许出现未在properties中显式定义的额外字段。当设置为false时，任何未在properties中声明的字段都会被验证器视为非法。这一特性在API设计中非常有用，可以严格限制请求和响应数据结构，防止意外的字段注入和数据污染。