LOCAL OPENAPI 3.X DIFF

API Contract Watch

比较两个本地 OpenAPI 3.x JSON 合同，在客户端遇到问题前发现潜在不兼容变化。

查看运行方式返回工具箱

当前支持

BREAKING

接口变化

endpoint、HTTP method、参数、request body、响应状态码和响应属性变化。

SCHEMA

结构变化

类型、enum、nullable、数组 items、嵌套对象和同文档引用。

本地运行

PYTHONPATH=src python3 -m api_contract_watch diff OLD.json NEW.json

输出支持 text、JSON、strict、severity 和文件输出。当前不上传 Schema，不提供账号或云端监控。

这是一个本地 CLI/API MVP。YAML、OpenAPI 2.x、跨文件引用、远程监控和 GitHub Actions 尚未纳入当前范围。