介绍

YApi 是高效易用功能强大的 api 管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API,YApi 还为用户提供了优秀的交互体验,开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。

当下稍微正式一点的公司都会要求前后端联调要求编写接口文档,比如说要求word或者excel等了,这个时候你要说那么我们可以使用swagger,但是领导又会说swagger不能留档,并且显得不太正式,结果就强制要求使用word,奈何太浪费时间,通过yapi,它可以直接导出文件进行存档,并且接口内容也可以通过swagger定时同步。

安装Yapi

自己搭建mongo

前提是需要安装mongdb用于存储数据,当前我已经安装了MongoDB,配置如下

docker run -p 27017:27017 --name mongo -e TZ=Asia/Shanghai  -d mongo

服务地址:192.168.1.12
端口:27017
数据库:yapi

通过docker生成yapi服务

docker run -p 8009:3000 --name yapiweb -e [email protected] -e YAPI_ADMIN_PASSWORD=123456 -e YAPI_CLOSE_REGISTER=true -e YAPI_DB_SERVERNAME=192.168.1.6 -e YAPI_DB_PORT=27017 -e YAPI_DB_DATABASE=yapi -e YAPI_MAIL_ENABLE=false -e YAPI_LDAP_LOGIN_ENABLE=false  -d jayfong/yapi:latest

开箱即用版本

# 纯粹的
docker run --rm -p 8009:3000 -d  jayfong/yapi:play

# 带插件的
docker run --rm -p 8009:3000 -e YAPI_PLUGINS='[{"name":"interface-oauth2-token"}]' -d jayfong/yapi:play

基本使用Yapi

登录

通过浏览器访问地址:http://localhost:8009/

接口管理平台YApi-LMLPHP

用户管理

查看用户

接口管理平台YApi-LMLPHP

添加用户

接口管理平台YApi-LMLPHP

个人项目

创建

接口管理平台YApi-LMLPHP

展示个人项目

接口管理平台YApi-LMLPHP

分组

创建分组

接口管理平台YApi-LMLPHP

分组成员

接口管理平台YApi-LMLPHP

分组动态

接口管理平台YApi-LMLPHP

添加接口

接口管理平台YApi-LMLPHP

修改接口

接口管理平台YApi-LMLPHP

搭配swagger

关于swagger基础配置可以查看:此处

创建项目

使用前文的.net程序,并显示swagger信息,swagger地址为:http://azrng.cn1.utools.club/swagger/index.html

接口管理平台YApi-LMLPHP

获取swagger的json地址

接口管理平台YApi-LMLPHP

Yapi配置

接口管理平台YApi-LMLPHP

查看同步数据

然后我们查看接口列表,这个时候我们已经看到项目的接口已经都被同步过来了

接口管理平台YApi-LMLPHP

数据管理

数据导出导入

在数据管理我们可以导入数据,或者导出数据

接口管理平台YApi-LMLPHP

导出预览

接口管理平台YApi-LMLPHP

微信公众号

接口管理平台YApi-LMLPHP

05-16 16:17