EOLINKER API Studio 已于近期发布5.0.5版本,该版本增强了 API 文档和数据报表功能,新增支持自定义 Mock API 功能,支持读取 gitlab 的 Java 代码注释生成 API 文档等。

本篇文章将会介绍 API Studio 5.0.5 新版本中新增和改进功能。API Studio 网址:https://www.eolinker.com

Mock API

1.支持自定义 Mock API

1.Mock API 成为独立功能,不再依赖于 API 文档中填写的返回参数。进入 API 详情页,点击"新建期望"按钮会弹窗创建 Mock API 的信息,原先已填写的 MOCK 数据,将会自动转为默认期望,如下图。
在这里插入图片描述
2.编辑 Mock API 期望页中可编辑信息为:

a.Mock API 期望名称;

b.请求触发条件(当请求信息中包含以下信息时返回指定内容);

其中"更多设置"包括

预期返回状态码(默认200)
返回延迟(默认0,最大延迟3000ms)
预期返回头部

c.预期返回数据,可选 Json 编辑器、Raw、Javascript,其中 Json 编辑器模式下支持导入 json 和导入文档的 Json 返回内容;Raw 模式适用于源数据;Javascript 模式支持运行 js,同时支持mockjs 语法。
在这里插入图片描述
3.存在相同的触发条件时,页面会提示重复。
在这里插入图片描述
4.新增预览功能,单击预览,会弹窗显示构造出来的 Mock API 数据。
在这里插入图片描述

数据报表

1.项目概况页能够查看未编写测试用例的 API 和测试用例数量较少的 API。
1.项目概况页的测试用例覆盖率根据百分比显示不同颜色,并且点击可以查看未编写测试用例的 API;

90%以上:绿色
60~90:黄色
60以下:红色
2.项目概况页的 API 测试用例覆盖系数根据数量显示不同颜色,并且点击可以查看测试用例数量较少的 API:

1个或以上:绿色
0.6~1:黄色
0~0.6:红色
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

API文档

1.扫描代码注释生成文档功能,目标语言除了 PHP 外,新增对 Java 的支持。
在这里插入图片描述
2.返回参数加入 JSON、XML、RAW 数据类型,支持 json 和 xml 相互转换。

1.API 文档的返回参数中加入 JSON、XML、RAW 三种数据类型,新的参数默认选择 json 类型。

2.如果原先文档已有数据,数据不设置类型,但再次编辑就会默认选中 json。

3.提供 json 和 xml 相互转换的功能(json 转 xml、xml 转 json),保留原有的导入 json /导入 xml 功能。
在这里插入图片描述

3.XML 类型的请求参数和返回参数默认有一个根节点。
由于 XML 结构原因,最外层的参数没有拖动调整顺序的功能,并且类型只有 Object,默认是必填并且无法取消。
在这里插入图片描述

4.API 详情页的请求参数类型如果是 json 的话,会显示 Json 的最外层结构是 Object 还是 Array 。
在这里插入图片描述

5.静态 Mock 内容若超出范围,超出部分会在保存时被自动截断。
在这里插入图片描述
6.新的 Mock 调用地址规则,mockapi.eolinker.com 将替换原有的 mock.eolinker.com
Mock 调用地址新的规则为:mockapi.eolinker.com/{project_hash_key}/{api_url},原有的 mock.eolinker.com 支持继续使用一段时间。
在这里插入图片描述
如果你在使用的过程中遇到了问题,请随时在博客下留言或者通过工单告知我们的工作人员,希望本篇文章能帮到您,再次感谢您对EOLINKER的支持。EOLINKER API Studio 网址:https://www.eolinker.com

Logo

CSDN联合极客时间,共同打造面向开发者的精品内容学习社区,助力成长!

更多推荐