还在手工写接口测试文档吗，已经out了

本文章出自【码同学软件测试】

码同学公众号：自动化软件测试，领取资料可加：Matongxue_8

码同学抖音号：小码哥聊软件测试

 

01    前言

 

 

接口文档，顾名思义就是对接口说明的文档。好的接口文档包含了对接口URL，参数以及输出内容的说明，我们参照接口文档就能编写出一个个的测试用例。而且接口文档详细的话，测试用例编写起来就会比较简单，不容易遗漏。

 

如果接口文档信息不全或是没有接口文档的情况下，领导要求我们做接口自动化测试，这无异是一个非常艰辛的任务。但是编写接口文档的工作量很大，怎么办呢？有什么自动化工具可以协助我们生成文档呢？

 

众里寻他千百度，最近我发现一款工具可以大大解放我们工作，自动生成接口文档。他就是YApi，先上图说明，这是我在YApi中做的接口文档，是不是蛮专业

 

 

02    YApi介绍

 

1、YApi 是什么呢

YMFE是去哪儿网移动架构组（YMFE）简称，是由FE，iOS和Android工程师共同组成的

 

• Yapi由YMFE开源，旨在为开发、产品、测试人员提供更优雅的接口管理服务，可以帮助开发者轻松创建、发布、维护 API。

• YApi成熟的团队管理扁平化项目权限配置满足各类企业的需求

• 基于websocket的多人协作接口编辑功能和类postman测试工具，让多人协作成倍提升开发效率

• Mock Server易用的Mock Server，再也不用担心mock 数据的生成了

• 自动化测试完善的接口自动化测试，保证数据的正确性

• 数据导入支持导入 swagger, postman, har 数据格式，方便迁移旧项目

 

2、界面如下

 

 

免费领取码同学软件测试课程笔记+超多学习资料+完整视频+面试题，可加微信：Matongxue_8

免费领取码同学软件测试课程笔记+超多学习资料+完整视频+面试题，可加微信：Matongxue_8

 

 

3、这是一个Mock接口数据维护例子

 

 

 

4、更为强大的是：

可以支持数据导入，和文档导出，可以把项目中的接口导出到HTML文件，同时在本地word中，就可以将HTML文档转换为word文档，更方便我们转播和存储。

 

 

03

安装使用

如何安装呢？直接采用docker安装最为简单（需要有docker使用基础）

 

1、安装mogodb;

docker  run -d --name mongo-yapi mongo;

 

 

 

免费领取码同学软件测试课程笔记+超多学习资料+完整视频+面试题，可加微信：Matongxue_8

免费领取码同学软件测试课程笔记+超多学习资料+完整视频+面试题，可加微信：Matongxue_8

 

 

2、拉取yapi

docker pull registry.cn-hangzhou.aliyuncs.com/anoy/yapi

 

3、初始化管理员账号和服务

docker run -it --rm

 --link mongo-yapi:mongo

 --entrypoint npm

 --workdir /api/vendors

 registry.cn-hangzhou.aliyuncs.com/anoy/yapi

 runinstall-server

 

 

 

4、初始化管理员账号和服务

启动YApi服务

docker run -d

 --name yapi

 --link mongo-yapi:mongo

 --workdir /api/vendors

 -p 3002:3000

 registry.cn-hangzhou.aliyuncs.com/anoy/yapi

 server/app.js

 

5、访问http://ip:3002

 

 

 

6、mock平台不足地方：

如果涉及后台业务，比如查询数据库 ，java方向可以采用springmvc 自己定制，这就需要具备测试开发能力了，例如自定义动态返回接口

 

 

 

 

END

免费领取码同学软件测试课程笔记+超多学习资料+学习完整视频 ☞ 可加：Matongxue_8／关注码同学公众号

本文著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。