已更新9月 2026
如何使用JSON 到 JSON 架构
- 粘贴一个代表性的 JSON 示例 — 完全填充胜过稀疏；真实的 API 响应效果很好。
- 读取推断的架构 - 自动转录的类型和结构。
- 细化契约：设置必填字段、添加值约束、决定附加属性。
- 部署它 - API 验证中间件、OpenAPI 规范或编辑器工具的“$schema”参考。
JSON 到 JSON 架构是什么？
JSON 到模式生成器读取示例文档并推断描述它的 JSON 模式：每个字段的类型（字符串、数字、布尔值、数组、对象）、嵌套结构和验证合约的骨架。向其提供真实的 API 有效负载，并获取可验证其形状的有效负载的架构。
JSON 架构是“数据必须如下所示”的标准 — API 请求/响应验证、配置文件检查、表单生成和代码生成都在其上运行。为现有结构手动编写模式是一项乏味的转录工作；从示例中进行推断会进行转录并留给您判断。
关于JSON 到 JSON 架构
粘贴一个代表性的 JSON 示例并获取推断的模式 - 类型、属性和结构映射，准备进行细化。
将推理转化为契约的细化：标记哪些属性是必需的（推理无法知道意图 - 它看到它们存在，而不是强制），添加示例无法表达的约束（数字的最小/最大值，字符串的最小长度/模式，封闭值集的枚举），并决定additionalProperties — 未知字段是否应通过验证。一个例子展示一个实例；你知道规则。
架构的工作原理：在传入的 API 请求到达业务逻辑之前对其进行验证、OpenAPI/Swagger 定义（嵌入 JSON 架构）、CI 中的配置验证以及编辑器自动完成 — VS Code 会在您键入时读取架构以自动完成并检查 JSON 文件。使用一个代表性示例：具有 null 或空数组的有效负载教导推断器的信息少于完全填充的有效负载。
常见问题解答
机器可检查的数据合约：验证 API 有效负载、配置文件和表单数据；支持 OpenAPI 定义；驱动编辑器自动完成和 linting。这是“JSON 类型”标准。
它可靠地获取类型和结构。它无法知道哪些字段是必需的、有效范围，或者“status”：“active”是否是自由文本或三个值的枚举 - 这些是意图，然后您添加它们。
它决定不在模式中的字段是否通过验证。 false 使合约严格（未知字段 = 错误）——有利于捕获拼写错误； true（默认）是宽松的——有利于向前兼容性。慎重选择。
类型联合：{"type": ["string", "null"]}。从字段为 null 的示例中进行推断可能会猜测只是“null” - 将其更正为字段真正允许的并集。
在 JSON 文件中引用它： {"$schema": "./my.schema.json", …} — VS Code 和大多数编辑器会在您编辑时自动完成键、标记错误类型并显示描述。最便宜的开发者体验赢得模式提供。