當接口欄位需要二選一、付款方式互斥、聯絡方式必須是 email 或 URL 時，只檢查 required 和 type 不夠。先用 JSON Schema 校驗 oneOf、const、additionalProperties 與 format，再用鍵路徑、JSON Pointer、JSONPath 和 Deep Diff 核對真實回應，判斷 Schema 是過嚴、過舊，還是接口資料真的不相容。
JSON Schema oneOf 校驗JSON Schema format 錯誤email format 校驗uri format 校驗互斥欄位校驗oneOf 分支衝突API Schema 相容性
適合哪些查看場景
payment.method=card 卻傳入 bankAccount，導致 oneOf 分支都不匹配
email、callbackUrl、date-time format 在發布前失效
互斥欄位同時出現導致表單或接口校驗失敗
用鍵路徑確認聯絡方式欄位真實位置
對比 v1/v2 回應決定 Schema 是否要放寬或升級
推薦查看路徑
- 先格式化 Schema 和 JSON 樣例
- 用 Schema 校驗 oneOf、const、required、additionalProperties 和 format
- 查看錯誤路徑與 keyword，判斷是分支衝突還是格式錯誤
- 用鍵路徑、Pointer 和 JSONPath 複核真實欄位位置
- 用 Deep Diff 對比版本變化並更新接口文件
相關工具入口
面向 oneOf 條件分支衝突、互斥欄位、const 規則、email/uri/date format 錯誤與接口發布前 Schema 相容性複核的排查流程。
JSON Schema 校驗查看
用 JSON Schema 校验 JSON 資料，定位 required 缺失、enum 不匹配、oneOf 分支冲突、format 错误、类型漂移、数组层级和错误路径。
JSON SchemarequiredenumJSON Schema 生成查看
根据 JSON 示例推断对象结构，生成可读的 JSON Schema 初稿，適合接口、配置和文档整理。
JSON Schema接口开发JSON 鍵路徑提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，適合接口字段盘点、数组结构回归、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Pointer 路徑查看
用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点，適合接口响应、字段改名新路径、配置定位和文档核对。
JSON PointerJSON路径JSONPath 解析查看
用 JSONPath 表達式查看 JSON 中匹配的資料、数量和路径，適合接口响应、日志資料、字段改名或数组结构变化后的空结果排查和嵌套配置字段定位。
JSONPathJSON接口JSON 深度對比查看
逐层查看两个 JSON 的新增、删除、类型变化和值变化，適合接口版本差异、字段删除影响、数组元素结构回归、配置和結構化資料排查。
JSONDiff深度对比JSON 格式化查看
格式化、压缩并校验 JSON 文字，快速查看结构、错误位置、压缩结果和接口返回内容是否正确。
JSON格式化校验常見問題
當接口欄位需要二選一、付款方式互斥、聯絡方式必須是 email 或 URL 時，只檢查 required 和 type 不夠。先用 JSON Schema 校驗 oneOf、const、additionalProperties 與 format，再用鍵路徑、JSON Pointer、JSONPath 和 Deep Diff 核對真實回應，判斷 Schema 是過嚴、過舊，還是接口資料真的不相容。
oneOf 和 anyOf 有什麼不同？
oneOf 要求資料只匹配一個分支；anyOf 允許匹配一個或多個分支。付款方式、互斥欄位和單一業務類型通常更適合先用 oneOf 檢查。
format 錯誤一定代表資料不能用嗎？
不一定。format 是發布前初篩信號，需要結合業務規則確認是否要嚴格要求 email、uri、date-time 或 uuid 格式。
繼續查看這些專題
把高頻工具需求整理成可收錄、可引用、可轉發的專題頁，讓使用者快速找到一組相關工具，也讓搜尋與 AI 更容易理解 Chakan。