Skip to content
YApi 是一个可本地部署的、打通前后端及QA的、可视化的接口管理平台
JavaScript CSS HTML
Branch: master
Clone or download

Latest commit

hellosean1025 Merge pull request #1819 from BBBigCat/feat-openapi-export-swagger
feat: 将导出项目接口文档为 swagger 文件接口加入 openapi
Latest commit 99bb83c Jun 11, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github chore: fix typo Apr 16, 2018
client fix: 测试集闪动问题 Apr 28, 2020
common fix: 高级 mock 无效的bug,增加对登录 email 空格的过滤, deepMath 增加对原型属性过滤 May 29, 2020
docs fix(docs): `接口` to `结构` Feb 20, 2020
exts Revert "fix: use lodash compare json other than lib isDeepMatch" May 22, 2020
server feat: 将导出项目接口文档为 swagger 文件接口加入 openapi Jun 8, 2020
static chore: update static file Apr 28, 2020
test opti: 优化 restful api 动态路由匹配算法,增加权重计算 Feb 13, 2019
.eslintignore feat: add swagger data import Oct 5, 2017
.eslintrc.js feat: 优化token,增加用户信息 Jan 30, 2019
.gitignore fix: tui-editor 按钮图标不显示问题 Nov 6, 2018
.npmignore opti: npm publish Nov 6, 2018
.npmrc 添加.npmrc文件 Jun 11, 2018
CHANGELOG.md docs: log May 29, 2020
LICENSE Update LICENSE Oct 11, 2017
README.md Update README.md Apr 20, 2020
config_example.json 自动化测试时服务端测试node默认2分钟没有返回就直接断掉连接,可以手动设置一个超时时间。 Apr 3, 2020
nodemon.json feat: add advance-mock Sep 17, 2017
npm-publish.js fix: npm publish bug Jan 15, 2019
package-lock.json chore: update static file Apr 28, 2020
package.json chore: version May 29, 2020
plugin.json 增加openapi导入插件 Jan 23, 2018
webpack.alias.js fix: pipe expression bug Nov 27, 2017
yapi-base-flow.jpg fix: bug修复 Sep 14, 2017
ydoc.js docs: opti Feb 15, 2019
ydocfile.js opti: docs Mar 7, 2018
ykit.config.js node path 兼容windows Mar 2, 2019

README.md

YApi 可视化接口管理平台

文档:

hellosean1025.github.io/yapi

平台介绍

avatar

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

QQ交流群:

644642474 主群可能已满

941802405 群2欢迎加入

特性

  • 基于 Json5 和 Mockjs 定义接口返回数据的结构和文档,效率提升多倍
  • 扁平化权限设计,即保证了大型企业级项目的管理,又保证了易用性
  • 类似 postman 的接口调试
  • 自动化测试, 支持对 Response 断言
  • MockServer 除支持普通的随机 mock 外,还增加了 Mock 期望功能,根据设置的请求过滤规则,返回期望数据
  • 支持 postman, har, swagger 数据导入
  • 免费开源,内网部署,信息再也不怕泄露了

内网部署

环境要求

  • nodejs(7.6+)
  • mongodb(2.6+)
  • git

安装

使用我们提供的 yapi-cli 工具,部署 YApi 平台是非常容易的。执行 yapi server 启动可视化部署程序,输入相应的配置和点击开始部署,就能完成整个网站的部署。部署完成之后,可按照提示信息,执行 node/{网站路径/server/app.js} 启动服务器。在浏览器打开指定url, 点击登录输入您刚才设置的管理员邮箱,默认密码为 ymfe.org 登录系统(默认密码可在个人中心修改)。

npm install -g yapi-cli --registry https://registry.npm.taobao.org
yapi server 

服务管理

利用pm2方便服务管理维护。

npm install pm2 -g  //安装pm2
cd  {项目目录}
pm2 start "vendors/server/app.js" --name yapi //pm2管理yapi服务
pm2 info yapi //查看服务信息
pm2 stop yapi //停止服务
pm2 restart yapi //重启服务

升级

升级项目版本是非常容易的,并且不会影响已有的项目数据,只会同步 vendors 目录下的源码文件。

cd  {项目目录}
yapi ls //查看版本号列表
yapi update //更新到最新版本
yapi update -v {Version} //更新到指定版本

教程

YApi 插件

代码生成

YApi docker部署(非官方)

YApi 一些工具

YApi 的一些客户

  • 去哪儿
  • 携程
  • 艺龙
  • 美团
  • 百度
  • 腾讯
  • 阿里巴巴
  • 京东
  • 今日头条
  • 唯品支付
  • 链家网
  • 快手
  • 便利蜂
  • 中商惠民
  • 新浪
  • VIPKID
  • 马蜂窝

Authors

License

Apache License 2.0

You can’t perform that action at this time.