JSON Schema oneOf / format 專題

JSON Schema oneOf / format 相容性、互斥欄位與 Email URL 格式校驗工具

面向 oneOf 條件分支衝突、互斥欄位、const 規則、email/uri/date format 錯誤與接口發布前 Schema 相容性複核的排查流程。

直接答案

當接口欄位需要二選一、付款方式互斥、聯絡方式必須是 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 是否要放寬或升級

推薦查看路徑

  1. 先格式化 Schema 和 JSON 樣例
  2. 用 Schema 校驗 oneOf、const、required、additionalProperties 和 format
  3. 查看錯誤路徑與 keyword,判斷是分支衝突還是格式錯誤
  4. 用鍵路徑、Pointer 和 JSONPath 複核真實欄位位置
  5. 用 Deep Diff 對比版本變化並更新接口文件

相關工具入口

面向 oneOf 條件分支衝突、互斥欄位、const 規則、email/uri/date format 錯誤與接口發布前 Schema 相容性複核的排查流程。

JSON Schema 校驗查看

用 JSON Schema 校验 JSON 資料,定位 required 缺失、additionalProperties / unevaluatedProperties 未知字段、dependentRequired / dependentSchemas 条件联动、allOf / anyOf / oneOf 分支冲突、not 禁用组合、contains 数组成员缺失、uniqueItems 数组重复、patternProperties 动态键名、format 错误、类型漂移、deep object / composed schema / 组合 Schema 漏出字段,以及 AJV instancePath / schemaPath / keyword 和 missingProperty 错误路径解释。

JSON SchemarequiredadditionalProperties

JSON Schema 生成查看

根据 JSON 示例推断对象结构,生成可读的 JSON Schema 初稿,適合接口、配置和文档整理。

JSON Schema接口开发

JSON 鍵路徑提取查看

提取 JSON 对象中的键路径、节点类型和层级深度,支持点路径与 JSON Pointer 输出,適合接口字段盘点、nodes 数组漂移、错误字段路径、映射对齐和导入前结构检查。

JSON键路径字段盘点

JSON Pointer 路徑查看

用 JSON Pointer 精确查看 JSON 中某个字段、数组项或根节点,適合接口响应、字段改名新路径、配置定位和文档核对。

JSON PointerJSON路径

JSONPath 解析查看

用 JSONPath 表達式查看 JSON 中匹配的資料、数量和路径,支持数组通配、递归查找、特殊键名 bracket 写法和 ?(@.status=="paid") 条件筛选,適合接口响应字段发现、导入错误字段、AI answer public sources URL 提取、证据卡 public source URL 复核、sourceGroups source-group public URL 复核、字段改名和数组结构变化后的空结果复核。

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。

日期生活Should Do

TDEE、BMR、睡眠週期與每日飲水量健康規劃查看專題

把 TDEE、BMR、BMI、健康體重、睡眠週期和每日飲水量整理成一條本地優先、非醫療化的查看路徑。

打開專題
金融稅務Must Do

股票盈虧、股息收益率、複利、存錢目標和通膨購買力計算查看專題

圍繞股票盈虧、股息收益率、每月定投複利、存錢目標倒推、退休缺口和通膨購買力折損的安全公式型查看路徑。

打開專題
SEO/GEOMust Do

中國 AI 搜尋答案來源與引用準備檢查

面向中國 AI 搜尋與問答系統的公開頁準備清單:原始碼可見性、標題主線、結構化資料、FAQ、內鏈、關鍵詞覆蓋、robots、sitemap、llms.txt 與日誌證據。

打開專題