最近公司在开发一款app,之前一直使用swagger做为接口的文档在线自动生成+功能测试,由于swagger是国外的一款管理工具,访问和使用起来不是很方便,所以团队决定寻找一款国内的接口管理以及接口测试工具,于是询问了下隔壁项目组现在使用的是哪款管理工具,隔壁项目组给我们推荐了DOClever,于是下载部署试用了一下,感觉就一个字 强!
一、先介绍下Swagger
Swagger™的目标是为REST APIs 定义一个标准的,与语言无关的接口,使人和计算机在看不到源码或者看不到文档或者不能通过网络流量检测的情况下能发现和理解各种服务的功能。当服务通过Swagger定义,消费者就能与远程的服务互动通过少量的实现逻辑。类似于低级编程接口,Swagger去掉了调用服务时的很多猜测。
浏览 Swagger-Spec 去了解更多关于Swagger 项目的信息,包括附加的支持其他语言的库。
Swagger官网地址:swagger.io/
二、再来介绍下DOClever
DOClever是一款开源免费的可视化接口管理工具,专业的api接口管理系统,集接口文档、接口自动化测试、Mock数据、团队协作、接口快照等于一身的移动时代首选接口管理平台!(官网介绍)
DOClever官网:www.doclever.cn
三,从Swagger导出Json到DOClever
1、从Swagger导出一份JSON文件,或复制Swagger上的项目地址
2、把导出的JSON文件导入到DOClever,如下图:
点击导入项目
这里支持两种导入方式
1、URL导入
2、JSON导入
无论我们选择那一中方式,当导入之后点击保存;这时我们会看到我们在Swagger上的项目已经导入到DOClever;
DOClever提供的项目导入可以很方便的帮助我们把在Swagger、rap、postman上面的已有项目快速迁移到DOClever上面;