DiagramPreview
基礎解析No AILocal previewExportSEO tool

JSON Schema 可视化

粘贴 JSON Schema,查看属性、类型、必填字段、数组、枚举和组合结构树。

範例
Schema 树就緒
你的 Schema 树会显示在这里。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

Schema 文档工作流json-schema-visualizerjson-schema-form-previewzod-schema-visualizertypescript-interface-visualizer
JSON Schema 表單預覽

把 JSON Schema 的屬性、必填項、列舉和格式轉成表單預覽。

開啟
Zod Schema 視覺化

Zod Schema 視覺化:把 Zod object schema 轉成驗證结构圖,适合表单、介面和設定驗證文档。

開啟
Protobuf Schema 視覺化

将 protobuf message、字段和引用关系視覺化为类圖。

開啟

AI Review beta

发布前做一次图表 Review

先用本地启发式检查语法、可读性、失败路径和交付风险。不会上传源码;远程 AI Review 需要用户主动提交。

本地 beta review 不发送 source、prompt 或 diagram content。

使用方法

  1. 1粘贴 JSON Schema 对象,或加载 payload contract 示例。
  2. 2检查必填字段、可选字段、数组 item 类型、enum 和组合结构。
  3. 3发布 API 文档前确认 descriptions 和 examples 是否足够。
  4. 4确认图和应用实际 validator 行为一致后再导出或复制。

常見場景

API 契约 reviewPayload 文档Schema 调试AI schema 校验破坏性变更 review

常見問題

這個工具可以在瀏覽器中使用嗎?

可以。大多數預覽、檢查與匯出都優先在瀏覽器端完成;AI 類工具只會把提示詞送到已設定的 API。

發布前應該檢查什麼?

確認圖表或檔案符合真實流程、標籤可讀、敏感資料已移除,且匯出的 SVG/PNG 仍適合文件 review。

它如何幫助文件工作流?

工具會把技術文字或檔案變成可 review 的視覺預覽,方便放進 README、ADR、runbook、issue 和 API 文件。

JSON Schema Visualizer 会把 properties、required、array、enum、oneOf、anyOf 和嵌套对象结构转成可 review 的 schema 图。

当 API payload 太深、表格难读,或者 AI 生成 schema 需要提交前检查时,这个工具很有用。

适合 review 破坏性变更、解释请求体、比较 schema 片段,以及准备符合校验规则的文档示例。

Demo:API 文档发布前 review 请求 schema

Schema 图最有价值的地方,是让必填字段、数组对象和组合结构一眼可见。

  • 必填字段应该和可选 metadata 明确区分。
  • enum 通常会变成 UI 状态或 SDK 常量,需要清楚展示。
  • oneOf 和 anyOf 需要文档解释,不应只靠图里的分支。
{
  "type": "object",
  "required": ["email", "plan"],
  "properties": {
    "email": {"type": "string", "format": "email"},
    "plan": {"type": "string", "enum": ["free", "pro"]},
    "metadata": {"type": "object", "additionalProperties": true}
  }
}

这个小 schema 已经包含必填字段、枚举状态和开放 metadata。

Schema Review:在客户端出错前发现破坏性变更

JSON Schema 图特别适合 API 演进评审。它能把 required 字段、enum 变化、嵌套数组、nullable 字段和 oneOf 分支展示得更清楚。

  • 新增 required 字段通常是破坏性变更,除非所有客户端已发送。
  • enum 新增值要和下游校验规则一起 review。
  • oneOf/anyOf 过深时,应把重点分支整理成 review notes。
{
  "type": "object",
  "required": ["id", "status"],
  "properties": {
    "status": {"enum": ["draft", "paid", "cancelled"]}
  }
}

搜索意图与使用边界

在 JSON Schema 进入 API 文档、表单或 SDK 交接前,先可视化契约结构。

适合

  • required 字段 review
  • 嵌套 object 和 array 检查
  • enum/default/reference 文档化

不适合与常见失败

不适合

  • 校验 schema 外的业务规则
  • 一个页面塞入大量无关 schema
  • 替代契约测试

常见失败原因

  • 缺少 required 会削弱文档约束
  • 深层嵌套应拆子 schema 检查
  • references 和 additionalProperties 需要明确 review

下一步工作流

JSON Schema 到表单和文档工作流

先预览 schema 结构,再打开表单预览,并把契约链接到 API 或 SDK 文档。

查看完整工作流

JSON Schema 可视化 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 JSON Schema 可视化。查看 JSON Schema 属性、类型、必填字段和组合结构。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • 使用者資料: { "title": "UserProfile", "type": "object", "required": [ "id", "email" ], "properties": { "id": { "type": "string" }, "email": { "type": "string", "format": "email" }, "roles": { ...
  • 產品: { "title": "Product", "type": "object", "required": [ "sku", "name", "price" ], "properties": { "sku": { "type": "string" }, "name": { "type": "string" }, "price": { "type": "numbe...
  • 事件載荷: { "title": "OrderEvent", "type": "object", "required": [ "type", "createdAt", "data" ], "properties": { "type": { "type": "string", "enum": [ "order.created", "order.paid", "order....

工具完成度

基礎解析

基礎解析

此工具偏向快速結構檢查,適合預覽、排查與定位問題;關鍵輸出進入正式流程前仍需人工複核。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。