跳到主要内容

新建迭代分支

进入项目后,点击左上角分支 tab 页中的“创建迭代分支”按钮,填写迭代分支名称后完成创建。

你也可以前往“项目设置” → 项目资源中的“管理迭代分支”,轻点右侧的“创建迭代分支”按钮进行创建。

开发者可以在迭代分支中编辑三大模块:接口、数据模型和响应组件。为了使得开发者更加聚焦于需要更新的内容,新建的迭代分支中默认不包含任何内容,你可以选择从主分支导入资源或直接新建资源。

信息

为了便于区分,迭代分支的按钮将高亮展示。

主分支与迭代分支对比

接口

导入接口

导入功能适合主分支内需要被修改的接口。点击页面左下角的“从主分支导入”按钮或直接点击页面中的“导入”按钮,选择需要被修改的特定目标接口。

导入完成后,迭代分支中的接口内容与主分支一致,你可以在此页面进行修改。在迭代分支内更新请求参数或变量时不会影响到主分支中的原接口。

新建接口

新建功能适合需要在迭代分支内全新开发的接口。点击菜单栏中的 + 按钮,然后轻点“新建接口”选项完成创建。

查看差异

编辑完成后,你可以点击接口目录栏右侧 icon,点击“与主分支对比差异”即可查看当前接口所做出的变更。

数据模型

数据模型是可复用的“数据结构”,能够批量管理 API 定义中的请求和响应的数据结构。

导入数据模型

导入功能适合需要在主分支内已有数据模型基础上进行修改的场景。点击页面左下角的“从主分支导入” → “选择数据模型” 按钮或直接点击页面中的“从主分支导入数据模型”选项,选择主分支中的数据模型。

新建数据模型

新建功能适合需要在迭代分支内全新开发的数据模型。点击菜单栏中的 + 按钮,然后轻点“新建数据模型”选项完成创建。

导入或新建完成后,你可以在当前分支编辑 API 文档时,新建数据结构并进行引用。

响应组件

一个接口的响应示例通常会分为成功示例失败示例,响应组件指的是用户自定义的响应数据结构,详细说明请参考《组件库》

导入响应组件

导入功能适合在主分支内已有组件库基础上进行调整与修改的场景。

点击页面左下角的“从主分支导入” → “选择响应组件” 按钮或直接点击页面中的“从主分支导入数据模型”选项,选择响应组件后进行导入。

新建响应组件

新建功能适合那些需要在迭代分支内独立使用的组件。点击菜单栏中的 + 按钮,然后轻点“新建响应组件”选项完成创建。

导入或新建完成后,迭代分支中的接口即可引用该响应组件。

测试场景

迭代分支也同样支持测试场景。对于新接口的测试工作,通常会新建测试场景以验收新增功能是否完善,但让仍在更新状态下的测试场景融入至主测试流程,有可能会影响到原来的测试流程。

使用迭代分支功能可以让新接口在分支内新建测试场景独立进行测试,整体的测试流程跑通后,再合并至主分支内的测试场景,让接口测试过程更加稳健。

新建测试场景

对于一些新的接口,或需要创建新的测试场景用来对迭代分支上的接口进行自动化测试时,你可以在新分支内新建测试场景,点击“新建测试场景”即可新建空白的测试场景进行编排。

从主分支导入测试场景

点击主分支导入“测试场景”,系统会自动把迭代分支内调整的接口以及相关的测试场景匹配出来,帮助测试人员可以快速找到以前已经写好的测试场景进行复制导入。结合迭代分支中改动的接口文档,对复制导入的测试场景稍加调整,即可完成对迭代分支中接口的自动化测试场景维护;你也可以选择任意分支上的测试场景,导入至迭代分支后独立进行维护。