全部工具文字與開發查看
只包含工具網址,不含輸入、檔案或結果

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 可引用说明页和开发文档复核。

baseSpec + targetSpec分别粘贴 OpenAPI / Swagger YAML 或 JSON 规范

只比较你粘贴的 OpenAPI / Swagger 文本。公开结果链接只应使用合成或脱敏规范,避免客户字段、内部域名、token、cookie 和私有路径进入 URL。

等待查詢

結果會在這裡以結構化卡片展示。

可直接查看的示例結果

精選短輸入與高頻排查場景,方便使用者一鍵打開、轉發,也讓搜尋與 AI 更容易理解工具用途。

必填變更

檢查 OpenAPI 必填參數變更

用合成規範複核 query 參數變必填、response required 欄位刪除與新增 endpoint 是否分開標示。

打開示例
requestBody

複核 Swagger requestBody 必填欄位

檢查 requestBody 新增必填欄位,並把新增 health endpoint 留在增量變化清單。

打開示例

常見問題

這些說明幫助使用者理解結果,也幫助搜尋引擎和 AI 更準確理解工具用途。

什么变化会被视为破坏性变更?

当前重点检查参数从可选变必填、requestBody 新增必填字段,以及响应 required 字段删除。新增接口会单独列为增量变化,不会算作破坏性变更。

新增接口是否也是破坏性变更?

通常不是。新增 endpoint 或 operation 会单独列为增量变化,便于发布说明和测试补充;只有伴随鉴权、路由优先级、默认行为或旧路径语义变化时,才需要人工升级为兼容性风险。

支持粘贴 Swagger YAML 吗?

支持。可以直接粘贴 OpenAPI / Swagger 的 YAML 或 JSON 文字,本工具会在浏览器本地解析。

会请求真实 API、Swagger URL 或私有仓库吗?

不会。它只处理当前页面粘贴的规范文字,適合合成或脱敏样例,不会主动抓取线上接口或第三方文档。

什麼變化會被這個檢查器視為破壞性變更?

目前重點檢查參數從可選變必填、requestBody 新增必填欄位,以及 response required 欄位刪除。新增接口會另列為增量變化。

這個工具會請求真實 API 或 Swagger URL 嗎?

不會。它只解析目前頁面貼上的 OpenAPI / Swagger 文字,適合用合成或脫敏規範做發布前複核。

如何區分 removed endpoint 和 response 欄位刪除?

removed endpoint 代表整個 operation 不再可用;response required 欄位刪除代表回應契約變弱,可能影響 SDK、前端渲染或資料入庫。兩者都需要相容性複核,新增接口則應留在增量變化清單。

相關長尾搜尋

這些詞結合工具名稱、查詢意圖與分類場景,方便切換相近需求,也幫助搜尋引擎理解頁面用途。

OpenAPI diff onlineSwagger breaking change checkAPI contract release reviewOpenAPI 必填參數變更Swagger response required 欄位刪除API 發布前相容性檢查OpenAPI / Swagger 破坏性变更查看OpenAPI / Swagger 破坏性变更線上查看