Postman在Ubuntu上的接口版本管理方法
1. 环境变量管理（基础且灵活）
通过创建不同环境对应不同API版本，实现快速切换。
- 创建环境：在Postman左侧“Environments”面板点击“+”，命名如“v1”“v2”（代表不同版本）。
- 配置变量：在环境设置中添加
API_VERSION变量（如v1环境设为v1，v2环境设为v2），还可添加BASE_URL（如https://api.example.com/{{API_VERSION}}）。
- 使用变量：在请求URL中用
{{BASE_URL}}/resource替代硬编码路径，在请求头中用Accept: application/json; version={{API_VERSION}}指定版本。
- 切换版本：通过顶部环境下拉菜单选择对应环境，Postman自动替换变量，无需修改每个请求。
2. 集合（Collections）组织（结构化管理）
将不同版本的API请求分组到对应集合，提升可维护性。
- 创建版本集合：点击左侧“Collections”→“+”，命名如“用户管理API v1”“用户管理API v2”。
- 添加请求：将同一版本的请求拖入对应集合，可进一步创建子文件夹（如“用户查询”“用户创建”）细化分类。
- 批量操作：选中集合后点击右侧“Run”，可批量执行该版本的所有请求，方便测试。
3. 内置版本控制（追踪变更历史）
直接对集合或环境进行版本管理，保留历史记录。
- 进入版本选项卡：选中目标集合或环境，点击右侧“版本”标签。
- 创建与保存版本：点击“保存当前版本”，输入版本名称（如“初始版本”“新增用户删除接口”）和描述（如“添加了用户更新接口”），保存后生成版本快照。
- 管理版本：在版本列表中可查看所有历史版本，点击“回滚”可恢复到指定版本，确保版本变更可追溯。
4. URL路径版本控制（常见实践）
在URL中直接嵌入版本号，直观且易于识别。
- 设计URL：不同版本的请求使用不同路径，如
GET /v1/users（v1版本）、GET /v2/users（v2版本）。
- 结合环境变量：将基础路径设为变量（如
{{BASE_URL}}/v1/users），通过切换环境快速改变版本，避免重复修改URL。
5. 请求头版本控制（灵活扩展）
通过请求头传递版本信息，不影响URL结构。
- 设置请求头：在请求的“Headers” tab中添加
Accept: application/json; version=2.0（指定v2版本），或X-API-Version: 1（自定义头）。
- 后端适配：后端服务根据请求头中的版本号路由到对应逻辑，适合需要隐藏URL变化的场景。
6. 集成Git进行版本控制（团队协作）
将Postman集合导出为JSON文件，纳入Git仓库管理，实现团队协同。
- 导出集合：选中集合→点击右侧“…”→“Export”→选择“Collection Format v2.1”→保存为
.json文件。
- Git同步：将JSON文件添加到Git仓库，团队成员可通过
git pull获取最新集合，git push提交变更，跟踪集合的历史修改。
7. Postman API自动化管理（编程控制）
通过Postman提供的RESTful API，用脚本自动化创建、更新版本。
- 获取API Key：在Postman账户设置中生成API Key（需“View and manage your Postman data”权限）。
- 调用API：使用
POST /collections/{collectionId}/versions接口创建集合版本，传入集合ID和版本描述；或使用PUT /environments/{environmentId}更新环境变量版本。
- 自动化流程：结合CI/CD（如Jenkins、GitHub Actions），在每次API变更后自动创建Postman版本，确保版本与代码同步。