suge-openapi-breaking-change-gate

面向 API 产品团队、外包交付、小型研发与平台工程：对一次 API 版本变更做离线的破坏性影响门禁。输入基准时间（带时区）、old_spec 与 new_spec（**仅 JSON 对象**）、可选 consumer_usage[]（client_id/method/path/fields/status_codes）、可选 waivers[]（id/reason/owner/expires_at，另可带 change_id 或 kind+path+method 用于匹配）与 as_of。支持 OpenAPI 3.x 常用结构：比较 path/method、参数位置与 required、requestBody required、媒体类型、schema type/format/required/enum、响应码与响应 schema、安全方案引用；远程 $ref 不取回，无法解析的本地引用标 UNKNOWN 并使总体判定为 PARTIAL。破坏性规则：删除 path/method/成功响应/媒体类型；新增必填参数或请求字段；收窄 enum；改变 type/format；可选改必填；移除调用方已用能力。新增可选字段默认非破坏，但 additionalProperties/oneOf/allOf/nullable 等复杂语义一律保守标人工复核。输出 PASS / BREAKING / REVIEW / PARTIAL / INVALID，附稳定 change_id、严重级别、证据路径、受影响调用方、未过期与已过期豁免、迁移清单与机器可读摘要。不运行代码生成、不访问远程 $ref、不修改规范、不宣称语义兼容性已完全证明。触发词：OpenAPI、接口变更、破坏性变更、兼容性门禁、API 版本升级、契约测试、调用方影响面。联系邮箱：43298568@qq.com。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本