直达重点

• 版本承载：使用 Header（如 Accept: application/vnd.api+json;version=2）或路径 /v2，一致且可路由
• 向后兼容：新增字段默认值、保留旧契约；弃用需设过渡期与告警
• 网关治理：路由转发按版本；灰度发布与金丝雀验证新版本
• 文档与测试：版本化文档；契约测试覆盖关键资源与错误码