Skip to content

版本管理

入口:【接口管理】=>【配置管理】=>【版本管理】

接口管理是基于版本管理的,管理接口之前,必须先有一个未发布的版本,版本管理规则如下:

  • 同时只能存在一个未发布版本;
  • 只有未发布版本下的接口是可以管理的,已发布版本的接口都是只读的;
  • 版本新增必须有前置版本,固定为已有版本的最新版本;如果是首次新增版本,则默认-1;

版本新增

点击新增按钮,弹出版本新增表单填写:

  • 版本名称:必填;
  • 描述:选填;
  • 复制前置版本:
    • 是:复制前置版本的所有接口到当前版本,默认勾选;
    • 否:只新增版本

img.png

版本编辑

版本编辑只支持版本基础信息(版本名称、描述)的修改

版本删除

点击对应版本右侧的删除按钮,弹出删除警告框:

  • 【确定】:将删除该版本及版本下所有接口及接口的关联信息,同时更正前置版本关系
  • 【取消】:放弃删除;

版本比较

点击版本比较按钮,将弹出版本比较对话框;选择基准版本,选择目标版本,点击比较按钮;将展示对比结果,对比结果有四个列表:

  • 源版本:只存在于基准版本的接口;
  • 相同接口:基准版本和目标版本都存在且相同的接口;
  • 差异接口:基准版本和目标版本都存在且有差异的接口;
  • 目标版本:只存在于目标版本的接口;

比较范围:基准版本的版本全量接口和目标版本的版本全量接口;

接口异同规则:如果接口在较新的版本有手动的变更记录,则认为接口有差异;否则认为是相同接口;

img.png

版本发布

版本发布前,需要确认该版本下所有需要审批的接口已审批通过,如果不满足条件则无法发布成功;

审批:点击【发起审批】,弹出未发布版本下所有待审批的接口,选择需要审批的接口,点击【提交审批】,则选中的接口进入流程中;可在流程管理的待办事项进行审批;

发布:点击【发布】=>【确认】,若版本下没有需要审批的接口或者需要审批的接口都审批通过,将成功发布,版本发布后,其下所有接口不可编辑、不可删除;