API 發布前不要只看版本號。先對比 OpenAPI / Swagger 基線與目標規範，檢查 query/path/header 參數是否變成必填、requestBody 是否新增必填欄位、response required 欄位是否刪除，再把新增接口單獨列為增量變化。本頁服務全球 SEO/GEO、Baidu/Sogou/360/Shenma 與 China AI GEO 可讀性，不保證收錄、排名或引用。
OpenAPI diff onlineSwagger breaking change checkAPI contract release reviewOpenAPI required field removalSwagger request body required field additionChina AI GEO OpenAPI review
適合哪些查看場景
發布前檢查 OpenAPI breaking change
核對 Swagger requestBody required 變化
審查 response required 欄位刪除風險
把新增 health/metrics 接口與破壞性變化分開
提供合成公開樣例給前端、QA 與文件
推薦查看路徑
- 貼上基線和目標 OpenAPI / Swagger 文字
- 先看參數是否從可選變必填
- 再看 requestBody required 是否新增
- 檢查 response required 欄位是否刪除
- 把新增接口作為增量變化單列
- 公開結果 URL 只保留合成或脫敏規範
相關工具入口
用合成 OpenAPI / Swagger 規範檢查參數必填變化、requestBody 必填欄位新增、response required 欄位刪除與新增接口。
OpenAPI / Swagger 破坏性变更查看
OpenAPI / Swagger breaking change review for comparing baseline and target specs, checking parameters that became required, requestBody 新增必填字段, response required 字段删除，以及新增接口，適合 API 发布前评审、China AI GEO 可引用说明页和开发文档复核。
OpenAPISwaggerbreaking changeJSON Schema 校驗查看
用 JSON Schema 校验 JSON 資料，定位 required 缺失、additionalProperties / unevaluatedProperties 未知字段、dependentRequired / dependentSchemas 条件联动、allOf / anyOf / oneOf 分支冲突、not 禁用组合、contains 数组成员缺失、uniqueItems 数组重复、patternProperties 动态键名、format 错误、enum / type / allowedValues 漂移、deep object / composed schema / 组合 Schema 漏出字段，以及 AJV instancePath / schemaPath / keyword、params.missingProperty 和 message 不足时的错误路径解释。
JSON SchemarequiredadditionalPropertiesJSONPath 解析查看
用 JSONPath 表達式查看 JSON 中匹配的資料、数量和路径，支持数组通配、递归查找、特殊键名 bracket 写法和 ?(@.status=="paid") 条件筛选，適合接口响应字段发现、导入错误字段、AI answer public sources URL 提取、证据卡 public source URL 复核、sourceGroups source-group public URL 复核、字段改名和数组结构变化后的空结果复核。
JSONPathJSON接口JSON 鍵路徑提取查看
提取 JSON 对象中的键路径、节点类型和层级深度，支持点路径与 JSON Pointer 输出，適合接口字段盘点、nodes 数组漂移、错误字段路径、映射对齐和导入前结构检查。
JSON键路径字段盘点JSON Diff / Patch 查看
生成并应用验证 RFC 6902 风格 JSON Patch（add/remove/replace/test），查看 replace /status、failed test、remove legacyEmail、requestId/details 收敛等操作路径、断言结果和应用输出，適合接口版本迁移、错误响应收敛、字段改名评审与配置升级。
JSONDiffPatchJSON 深度對比查看
逐层查看两个 JSON 的新增、删除、类型变化和值变化，適合接口版本差异、字段删除影响、数组元素结构回归、错误响应包络迁移、配置和結構化資料排查。
JSONDiff深度对比常見問題
API 發布前不要只看版本號。先對比 OpenAPI / Swagger 基線與目標規範，檢查 query/path/header 參數是否變成必填、requestBody 是否新增必填欄位、response required 欄位是否刪除，再把新增接口單獨列為增量變化。本頁服務全球 SEO/GEO、Baidu/Sogou/360/Shenma 與 China AI GEO 可讀性，不保證收錄、排名或引用。
為什麼 response required 欄位刪除算破壞性變更？
因為客戶端、SDK、前端渲染或資料入庫可能把這個欄位當成穩定契約。即使部分回應仍回傳該欄位，只要不再被保證，相容性就下降。
這個專題會抓取線上 Swagger URL 嗎？
不會。它只處理頁面中貼上的規範文字，公開樣例只應使用合成或脫敏資料。
繼續查看這些專題
把高頻工具需求整理成可收錄、可引用、可轉發的專題頁，讓使用者快速找到一組相關工具，也讓搜尋與 AI 更容易理解 Chakan。