Skip to content
/ yapi Public
forked from oyhanyu/yapi

YApi 是一个可本地部署的、打通前后端及QA的、可视化的接口管理平台,前端开发时只需要在package.json中配置代理即可

License

Notifications You must be signed in to change notification settings

pilipa-cn/yapi

 
 

Repository files navigation

YApi 可视化接口管理平台

平台介绍

avatar

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

QQ交流群: 644642474

特性

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

内网部署

环境要求

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

安装

方式一:使用我们提供的 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 

方式二. 命令行部署 如果 github 压缩文件无法下载,或需要部署到一些特殊的服务器,可尝试此方法

cd yapi
git clone https://github.com/YMFE/yapi.git vendors //或者下载 zip 包解压到 vendors 目录
cp vendors/config_example.json ./config.json //复制完成后请修改相关配置(删除mongo的用户名和密码)
cd vendors
npm install --production --registry https://registry.npm.taobao.org
npm run install-server //安装程序会初始化数据库索引和管理员账号,管理员账号名可在 config.json 配置
node server/app.js //启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候

使用

1、前端代理配置

"proxy": {
    "/api/": {
      "target": "http://localhost:3000/mock/11",
      "secure": true,
      "changeOrigin": true
    }
  }

 说明:target中的“11”是yapi在创建项目时随机生成的项目唯一标识,请求的完整的url为http://127.0.0.1:3000/mock/11/api/getUser,在异步请求中只需要写‘/api/getUser’即可,上线时无需修改。

升级

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

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

在线 Demo

yapi.demo.qunar.com

管理员账号

用户名: yapi.demo@admin.com
密码: ymfe.org

YApi 资源

YApi 的一些客户

  • 去哪儿
  • 携程
  • 艺龙
  • 京东
  • 唯品支付
  • 链家网
  • 快手
  • 便利蜂

Authors

License

Apache Licene 2.0

About

YApi 是一个可本地部署的、打通前后端及QA的、可视化的接口管理平台,前端开发时只需要在package.json中配置代理即可

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 60.0%
  • HTML 33.1%
  • CSS 6.9%