版本管理
当需要分析API每次发布的更新内容,或API发布后发生异常,可借助API的版本管理进行问题定位、版本回退等操作。
API的发布才会形成版本。保存、提交操作并不会记录为一个版本。
tip
API发布、提交与其他状态操作可参考发布
进入「API管理-API」菜单内,点击某个API,在展开的右侧面板中点击「版本」,可查看此API记录的版本信息。当API处于已完成编辑并保存,当并未提交、发布时,将会在版本记录的第一行显示「保存」,表示用户最近执行了保存的操作,并未提交或发布,列在其中是为了便于对比差异。同理,将API「提交」之后,首行记录将变为「提交」,如下图所示:
API的版本号从V1.0开始,采用逢10进1的规则。本平台仅保留最近20条版本记录(含最近一次保存(或提交))。
任选2个版本,点击「对比」,可对API的内容明细进行对比,如下图所示:
点击版本对比弹窗中的「回滚至xx」,将不会立即回滚至对应的版本,而是进入编辑页面。用户需确认此版本的内容信息,重新保存、提交、发布,完成API的发布过程。
info
保存、提交,以及最近一次发布的版本是不支持回滚的。