江苏龙网

  1. 主页 > 生活百科 > >

试试YApi进行接口文档管理

Yapi


试试YApi进行接口文档管理

文章插图
一、前言在我们后端开发中，必不可少的是接口的交接，有很多种方式，常见的就是swagger，不过这个侵入性太强了 。还有就是接口文档的框架，比如今天小编带大家一起搭建的yapi，在公司还是挺常见的！ 今天小编就大家从搭建到使用，详细的教学一波哈！
二、介绍1、平台介绍
试试YApi进行接口文档管理

文章插图
YApi 是高效、易用、功能强大的 api 管理平台，旨在为开发、产品、测试人员提供更优雅的接口管理服务 。可以帮助开发者轻松创建、发布、维护 API，YApi 还为用户提供了优秀的交互体验，开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理 。
2、特性
  • 基于 Json5 和 Mockjs 定义接口返回数据的结构和文档，效率提升多倍 。
  • 扁平化权限设计，即保证了大型企业级项目的管理，又保证了易用性 。
  • 类似 postman 的接口调试 。
  • 自动化测试, 支持对 Response 断言 。
  • MockServer 除支持普通的随机 mock 外，还增加了 Mock 期望功能，根据设置的请求过滤规则，返回- - 期望数据 。
  • 支持 postman, har, swagger 数据导入 。
  • 免费开源，内网部署，信息再也不怕泄露了 。
3、环境支持
  • nodejs（7.6+)
  • mongodb（2.6+）
  • git
在Docker中只需要搭建一下mongo，用来数据的存储即可！
三、运行mongo1、创建网络docker.NETwork create yapi
  • 1.
2、创建挂载文件mkdir -p /data/mongo
  • 1.
3、运行mongodocker run -d--name mongodb--restart always--net=yapi-p 27017:27017-v /data/mongo:/data/db-e MONGO_INITDB_DATABASE=yapi-e MONGO_INITDB_ROOT_USERNAME=yapi-e MONGO_INITDB_ROOT_PASSword=yapimongo
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
启动 MongoDB，其中 -e 指定 MONGO_INITDB_ROOT_USERNAME 为 MongoDB 的 ROOT 用户名，MONGO_INITDB_ROOT_PASSWORD 为 MongoDB 的 ROOT 用户密码 。

试试YApi进行接口文档管理

文章插图
4、进入容器初始化数据库进入 MongoDB 容器，从上图查看 MongoDB 容器可以获取到容器 id，以下示例使用 50f1f6c50139代表 MongoDB 的容器 id，只需要简写即可！
docker exec -it 50 /bin/bash
  • 1.
接着输入：
mongosh
  • 1.
「新版本需要加上sh，不然无法进入！」
试试YApi进行接口文档管理

文章插图
use admin;db.auth("yapi", "yapi");# 创建 yapi 数据库use yapi;# 创建给 yapi 使用的账号和密码，限制权限db.createUser({user: 'yapi',pwd: 'yapi',roles: [ { role: "dbAdmin", db: "yapi" }, { role: "readWrite", db: "yapi" }]});# 退出 Mongo Cliexit# 退出容器Ctrl+P+Q
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.

试试YApi进行接口文档管理

文章插图
四、运行yapi1、搭建挂载配置文件mkdir -p /data/yapi
  • 1.

vim config.json
  • 1.

{"port": "3000","adminAccount": "wangzhenjun1221@163.com","timeout":120000,"db": {"servername": "mongo","DATABASE": "yapi","port": 27017,"user": "yapi","pass": "yapi","authSource": ""},"mAIl": {"enable": true,"host": "smtp.gmail.com","port": 465,"from": "*","auth": {"user": "wangzhenjun1221@163.com","pass": "xxx"}} }


推荐阅读


上一篇：高并发中的线程与线程池

下一篇：谷歌发布 AI 代码编辑器 IDX：借助云虚拟机简化开发环境配置