关于【eolinker4.0开源】API文档功能和API测试功能的搭建、搭建API文档、使用自动化测试、测试环境切换

搭建

从gitee下载eolinker4.0源码

GitHub - linganmin/eolinker4.0: eoLinker是目前全球领先、国内最大的在线API接口管理平台，提供自动生成API文档、API自动化测试、Mock测试、团队协作等功能，旨在解决由于前后端分离导致的开发效率低下问题。

下载的源码解压到网站根目录，配置站点

创建数据库eolinker_os

运行 https://项目/index.php 进行安装

设置数据库账号密码后，点击下一步直到完成

在数据库上执行sql语句添加管理员

INSERT INTO `eolinker_os`.`eo_user` (`userID`, `userName`, `userPassword`, `userNickName`) VALUES ('1', 'admin', '14e1b600b1fd579f47433b88e8d85291', 'admin');

账号：admin

密码：123456

再次运行 https://项目/index.php 进行登录

登录成功的界面：

这里的test项目是我自己创建测试用的

安装自动化测试插件

这里安装的插件是当前浏览器上的插件，而非系统插件，下载地址：

GitHub - eolinker/eolinker-api-test-plugins at 4.0

搭建API文档

添加接口

这里需要注意的地方是:

1，在请求参数设置这里，如果请求参数是默认值，就需要在示例上填写，方便单接口测试和自动化测试的时候自动输入

2，在返回参数这里，需要导入json值，用于自动化测试传给下一个接口时使用

自动化测试

创建测试用例

接口1

接口2

如果在api管理的返回参数没有导入json，创建测试用例添加已有接口的时候，创建的测试api不会自动写入返回参数，下一个接口在点击关联的时候，关联的字段数据是空的。

其次就是，这里选择了关联字段后，需要设置第几个参数，如[0]表示上一个接口返回参数的数组中的第一个数据下的数据。因为关联字段的时候，是不会显示是否有数组，默认都是对象

遇到的问题：

在自动化测试的时候，GET提交使用 源数据的方式可以正常提交，POST提交时使用源数据时，后端无法获得数据，使用表达的时候又可以。可能源数据不支持POST提交

使用自动化测试

从测试接口详情可以看到，成功获取到了【接口1】返回的参数数据并写入到 【接口2】中的请求参数platformgood_category_id字段上。

环境管理设置

环境管理用于 api测试的时候，对各个环境进行切换。不同环境下 环境域名、全局变量、额外参数都不同，设置环境可以方便 测试的时候 不同系统的切换，尤其是 本地环境、测试外网 甚至 正式网的测试账号的测试。

前置URL

用于设置当前环境下所有测试url的域名设置，以及http协议和https协议

请求Header头部和额外参数

在添加测试api的时候，不需要重复添加 环境的请求Header头部和通用的额外参数，如wxapp_id参数就是所有请求都会添加并且固定值的参数，不需要每个测试api都填写。在测试的时候会 系统会自动把 环境请求Header头部和额外参数 都写入。

全局变量

用于切换用户或者切换项目时使用，使用方式是在测试api接口参数填写{{全局变量名}}，如我设置的是token遍历，那么使用的时候是{{token}}

切换环境

在系统的右上角进行环境切换，切换后直接使用当前环境的系数