JSON Schema 校验器
左侧输入JSON Schema,右侧输入待校验JSON数据,实时校验并展示具体错误路径与原因,附OpenAI Function Calling格式示例。
免费在线工具
Loading…
使用说明
- 在左侧「JSON Schema」文本框输入Schema定义,右侧「待校验 JSON 数据」文本框输入要校验的数据。
- 输入变化时会自动实时校验,也可点击「开始校验」按钮手动触发。
- 校验通过时显示绿色「校验通过」提示;校验失败时会逐条列出错误,包括具体字段路径(如
data.age、data.items[2])和失败原因(如「应为number类型,实际为string类型」)。 - 点击「加载示例数据」查看一个包含required/enum/pattern等多种关键字的示例。
- 点击「加载 OpenAI Function Calling 示例」可快速加载一个典型的 Function/Tool 定义 JSON Schema 及匹配的参数数据,用于校验大模型工具调用参数格式是否正确。
功能介绍
- 支持关键字子集:type(含integer,number且为整数)、required、properties、enum、minLength、maxLength、minimum、maximum、pattern、items、additionalProperties,覆盖日常JSON数据结构校验的常见需求。
- 明确不是完整JSON Schema Draft规范实现,不支持 $ref、oneOf、anyOf、allOf 等高级组合关键字,页面下方有明确说明。
- 校验失败时精确定位到具体字段路径(支持嵌套对象
data.user.age和数组下标data.items[2]),并给出人类可读的失败原因。 - additionalProperties设为false时会检测并报告多余字段。
- 内置「OpenAI Function Calling 格式示例」一键加载按钮,方便校验大模型工具调用(tool/function calling)的参数Schema定义是否正确。
- 纯本地JavaScript校验,不上传Schema或数据内容。
使用场景
校验大模型Function Calling参数
在为OpenAI/Claude等大模型定义Function Calling工具时,先用本工具校验参数Schema与示例调用参数是否匹配,减少联调错误。
API请求/响应结构校验
在开发后端接口时,用JSON Schema定义请求体或响应体结构,快速校验测试数据是否符合约定格式。
配置文件格式校验
校验JSON格式的配置文件是否符合预期结构,如必填字段是否缺失、枚举值是否合法等,避免因格式错误导致的运行时故障。
前端表单数据校验设计
在设计表单数据结构时,用JSON Schema描述字段类型、长度、取值范围等约束,验证测试数据是否符合设计预期。
常见问题
支持完整的JSON Schema规范吗?
不支持。本工具只实现了常用关键字子集(type/required/properties/enum/minLength/maxLength/minimum/maximum/pattern/items/additionalProperties),不支持 $ref、oneOf、anyOf、allOf、$defs 等高级特性,复杂场景请使用专业的JSON Schema校验库。
type支持哪些取值?
支持 string、number、integer、boolean、object、array、null。其中 integer 会额外校验数值是否为整数,number 则允许任意数字(含小数),这与OpenAI Function Calling中常见的参数定义方式一致。
校验失败的错误信息是什么格式?
每条错误包含具体的字段路径(如 data.age、data.items[2])和失败原因说明,例如「应为number类型,实际为string类型」,方便快速定位问题字段。
什么是OpenAI Function Calling示例?
这是一个典型的大模型工具调用(Function/Tool Calling)参数Schema定义示例,展示了如何用type、properties、enum、required等关键字描述一个查询天气的函数参数结构,点击对应按钮可一键加载。