EOLINKER API Studio 已于近期发布5.0.4版本,该版本强化了 API 管理以及自动化测试的功能,新增支持读取 gitlab 的 php 代码注释生成 API 文档、迭代计划管理功能等。
本篇文章将会介绍 API Studio 5.0.4 新版本中新增功能。
一、API研发管理
1.支持读取 gitlab 的 php 代码注释生成 API 文档(专业版和企业版支持)。
在项目概况页加入
“扫描代码注解生成文档”板块,支持读取 gitlab 的 php 代码注释生成 API 文档。设置相关信息后点击“立即同步”,可以自动读取代码注释生成 API 文档。
[caption id="" aLIgn="aLIgncenter" widTH="1691"]

5.0.4的项目概况页面[/caption]
扫描代码注解设置(固定参数):
- 代码仓库类型:Gitlab
- 注解格式:Swagger 2.0
- 数据同步方式:增量更新、全量更新、仅添加新的 API(3种方式可选)
2.项目概况页加入迭代计划管理,用于管理多个 API 的开发任务。
[caption id="" aLIgn="aLIgncenter" widTH="1497"]

5.0.4版本的批量绑定API到迭代计划[/caption]
[caption id="" aLIgn="aLIgncenter" widTH="923"]

之前的API批量操作页面[/caption]
- 不限制计划创建数量,但是在概况页对应板块中只显示开始时间最早的三个计划。
- 迭代计划会被放入横向时间轴中,并且迭代计划会按照各个 API 的类型进行划分颜色(颜色顺序和 API 统计的一致)。
- 完成度指的是启用状态的 API 占计划内 API 的百分比,整个进度条是绿色时代表启用率为100%,进度条是灰色时代表迭代计划没有绑定 API。
[caption id="" aLIgn="aLIgncenter" widTH="1676"]

概况页增加管理迭代计划[/caption]
[caption id="" aLIgn="aLIgncenter" widTH="1680"]

点击管理迭代计划会弹出弹窗[/caption]
[caption id="" aLIgn="aLIgnnone" widTH="606"]

点击新建迭代计划[/caption]
3.导入 JSON、XML、请求头部等数据支持增量更新。如果导入的数据中有注释,将会自动识别注释,将注释填写到说明中,识别发现数据注释和文档说明一样时,将自动跳过注释。之前界面中的“插入”改为“
在末端插入”,将“替换”改为“
全量替换”。
[caption id="" aLIgn="aLIgncenter" widTH="1501"]

5.0.4的导入弹窗界面[/caption]
[caption id="" aLIgn="aLIgncenter" widTH="651"]

之前的导入弹窗界面[/caption]
4.API列表新增“
搜索”标签列,创建者列调整在更新者列左侧。如果列表中的API 的 URL 过长,允许换行(最多2行)。
[caption id="" aLIgn="aLIgncenter" widTH="1848"]

5.0.4的API列表界面[/caption]
[caption id="" aLIgn="aLIgnnone" widTH="1267"]

之前的API列表界面[/caption]
5.高级搜索API中,关键字调整为可选项,新增支持标签搜索。
[caption id="" aLIgn="aLIgncenter" widTH="1536"]

5.0.4的API搜索界面[/caption]
[caption id="" aLIgn="aLIgncenter" widTH="727"]

之前的API搜索界面[/caption]
6.API 编辑页支持指定负责人,同时会显示在 API 文档页面。
[caption id="" aLIgn="aLIgncenter" widTH="1532"]

5.0.4的API编辑页面[/caption]
[caption id="" aLIgn="aLIgncenter" widTH="1498"]

5.0.4的API文档页面[/caption]
二、自动化测试
1.自动化测试下载列表显示正确率,100%通过显示绿色,其他情况用红色表示。
[caption id="" aLIgn="aLIgncenter" widTH="1536"]

5.0.4的测试报告下载界面[/caption]
[caption id="" aLIgn="aLIgncenter" widTH="870"]

之前的测试报告下载界面[/caption]
如果你在使用过程中遇到了什么问题,欢迎在下方留言告诉我们。感谢大家继续关注和支持EOLINKER!