JSON Schema 校验
draft-07 高频关键字校验,错误按 JSON Pointer 路径定位。
请同时提供 JSON 数据与 Schema 两份输入。
原因:校验 = 数据 × 规则,缺一边无法进行。
建议:左边贴数据(接口响应/LLM 输出),右边贴 Schema。
左侧贴数据、右侧贴 Schema,校验结果与错误路径会显示在这里。
使用说明
这个工具解决什么问题
AI 结构化输出、接口联调都绕不开同一个动作:拿一份 JSON 对照 Schema 查合不合规。引 Ajv 起项目嫌重,肉眼核对又漏。这个工具实现 draft-07 高频关键字的校验,覆盖 type/enum/const/required/properties/additionalProperties/items/min-max 系列/pattern/multipleOf 等,支持 type 数组含 null 的可空写法;错误以 JSON Pointer 路径定位到具体字段,不用翻。校验在浏览器本地完成,数据不上传。
核心能力
高频关键字:draft-07 常用关键字全覆盖,含 min-max 系列与 pattern。可空写法:type 数组含 null 的写法正常处理。路径定位:错误按 JSON Pointer 指到字段,如 /data/items/0/price。能力边界明示:检测到 $ref/allOf/oneOf/if-then-else 会在结果中说明,不静默跳过。零上传:粘贴即校验,数据不出本机。
使用建议
校验 AI 结构化输出时把 Schema 和模型返回一并贴入,报错先看路径最深的几条,通常就是越界字段;接口契约核对建议把文档示例作为 Schema 逐次核对响应。Schema 里用到组合关键字时先看工具的明示提示,别把「未实现」误读成「校验通过」;需要全量规范的场景交给 Ajv 等库处理。
常见问题
支持哪些关键字?
draft-07 的高频子集:type(含数组写法与 null 可空)、enum、const、required、properties、additionalProperties、items、minItems/maxItems、minLength/maxLength、minimum/maximum、pattern、multipleOf 等。日常接口契约校验够用。
不支持哪些关键字?会怎样?
不支持 $ref、allOf、oneOf、if-then-else 等组合与引用关键字。校验时检测到会在结果中明示「该关键字未实现」,而不是装作校验过。需要完整规范请用 Ajv 等成熟库。
错误路径怎么读?
错误以 JSON Pointer 路径给出,如 /data/items/0/price 表示 data 数组第 0 项的 price 字段不合规,顺着路径直接定位,不用在大 JSON 里肉眼找。
典型用途是什么?
AI 结构化输出校验(模型返回的 JSON 是否符合约定 schema)与接口契约核对(响应结构与文档是否一致),粘贴即校验,纯浏览器本地运行。