版本管理
入口:【接口管理】=>【配置管理】=>【版本管理】
接口管理是基于版本管理的,管理接口之前,必须先有一个未发布的版本,版本管理规则如下:
- 同时只能存在一个未发布版本;
- 只有未发布版本下的接口是可以管理的,已发布版本的接口都是只读的;
- 版本新增必须有前置版本,固定为已有版本的最新版本;如果是首次新增版本,则默认-1;
版本新增
点击新增
按钮,弹出版本新增表单填写:
- 版本名称:必填;
- 描述:选填;
- 复制前置版本:
- 是:复制前置版本的所有接口到当前版本,默认勾选;
- 否:只新增版本
版本编辑
版本编辑只支持版本基础信息(版本名称、描述)的修改
版本删除
点击对应版本右侧的删除
按钮,弹出删除警告框:
- 【确定】:将删除该版本及版本下所有接口及接口的关联信息,同时更正前置版本关系
- 【取消】:放弃删除;
版本比较
点击版本比较
按钮,将弹出版本比较对话框;选择基准版本,选择目标版本,点击比较
按钮;将展示对比结果,对比结果有四个列表:
- 源版本:只存在于基准版本的接口;
- 相同接口:基准版本和目标版本都存在且相同的接口;
- 差异接口:基准版本和目标版本都存在且有差异的接口;
- 目标版本:只存在于目标版本的接口;
比较范围:基准版本的版本全量接口和目标版本的版本全量接口;
接口异同规则:如果接口在较新的版本有手动的变更记录,则认为接口有差异;否则认为是相同接口;
版本发布
版本发布前,需要确认该版本下所有需要审批的接口已审批通过,如果不满足条件则无法发布成功;
审批:点击【发起审批】,弹出未发布版本下所有待审批的接口,选择需要审批的接口,点击【提交审批】,则选中的接口进入流程中;可在流程管理的待办事项进行审批;
发布:点击【发布】=>【确认】,若版本下没有需要审批的接口或者需要审批的接口都审批通过,将成功发布,版本发布后,其下所有接口不可编辑、不可删除;