API Versioning
API 版本控制管理接口变更，使新版本不破坏旧客户端，常见 URL 路径/头部/查询参数版本。
用途
管理 API 演进，保证向后兼容与平滑迁移。
机制
URL 路径：/v1/users（显式简单）。头部：Accept: application/vnd.api+json;version=1（RESTful）。查询：?version=1。语义版本：major 破坏兼容、minor 新功能、patch 修复。废弃旧版本需过渡期。
用例
- API 管理
- 向后兼容
- 版本演进
API 版本控制管理接口变更，使新版本不破坏旧客户端，常见 URL 路径/头部/查询参数版本。
管理 API 演进，保证向后兼容与平滑迁移。
URL 路径：/v1/users（显式简单）。头部：Accept: application/vnd.api+json;version=1（RESTful）。查询：?version=1。语义版本：major 破坏兼容、minor 新功能、patch 修复。废弃旧版本需过渡期。