建站
咨詢
售后
建站咨詢
新聞中心
一、前言
在我們后端開發(fā)中，必不可少的是接口的交接，有很多種方式，常見的就是swagger，不過(guò)這個(gè)侵入性太強(qiáng)了。還有就是接口文檔的框架，比如今天小編帶大家一起搭建的yapi，在公司還是挺常見的！ 今天小編就大家從搭建到使用，詳細(xì)的教學(xué)一波哈！
成都創(chuàng)新互聯(lián)公司成立于2013年，先為烏翠等服務(wù)建站，烏翠等地企業(yè)，進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為烏翠企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問(wèn)題。
二、介紹
1、平臺(tái)介紹
YApi 是高效、易用、功能強(qiáng)大的 api 管理平臺(tái)，旨在為開發(fā)、產(chǎn)品、測(cè)試人員提供更優(yōu)雅的接口管理服務(wù)。可以幫助開發(fā)者輕松創(chuàng)建、發(fā)布、維護(hù) API，YApi 還為用戶提供了優(yōu)秀的交互體驗(yàn)，開發(fā)人員只需利用平臺(tái)提供的接口數(shù)據(jù)寫入工具以及簡(jiǎn)單的點(diǎn)擊操作就可以實(shí)現(xiàn)接口的管理。
2、特性
- 基于 Json5 和 Mockjs 定義接口返回?cái)?shù)據(jù)的結(jié)構(gòu)和文檔，效率提升多倍。
- 扁平化權(quán)限設(shè)計(jì)，即保證了大型企業(yè)級(jí)項(xiàng)目的管理，又保證了易用性。
- 類似 postman 的接口調(diào)試。
- 自動(dòng)化測(cè)試, 支持對(duì) Response 斷言。
- MockServer 除支持普通的隨機(jī) mock 外，還增加了 Mock 期望功能，根據(jù)設(shè)置的請(qǐng)求過(guò)濾規(guī)則，返回- - 期望數(shù)據(jù)。
- 支持 postman, har, swagger 數(shù)據(jù)導(dǎo)入。
- 免費(fèi)開源，內(nèi)網(wǎng)部署，信息再也不怕泄露了。
3、環(huán)境支持
- nodejs（7.6+)
- mongodb（2.6+）
- git
在docker中只需要搭建一下mongo，用來(lái)數(shù)據(jù)的存儲(chǔ)即可！
三、運(yùn)行mongo
1、創(chuàng)建網(wǎng)絡(luò)
docker network create yapi2、創(chuàng)建掛載文件
mkdir -p /data/mongo3、運(yùn)行mongo
docker 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=yapi \
mongo啟動(dòng) MongoDB，其中 -e 指定 MONGO_INITDB_ROOT_USERNAME 為 MongoDB 的 ROOT 用戶名，MONGO_INITDB_ROOT_PASSWORD 為 MongoDB 的 ROOT 用戶密碼。
4、進(jìn)入容器初始化數(shù)據(jù)庫(kù)
進(jìn)入 MongoDB 容器，從上圖查看 MongoDB 容器可以獲取到容器 id，以下示例使用 50f1f6c50139代表 MongoDB 的容器 id，只需要簡(jiǎn)寫即可！
docker exec -it 50 /bin/bash接著輸入：
mongosh「新版本需要加上sh，不然無(wú)法進(jìn)入！」
use admin;
db.auth("yapi", "yapi");
# 創(chuàng)建 yapi 數(shù)據(jù)庫(kù)
use yapi;
# 創(chuàng)建給 yapi 使用的賬號(hào)和密碼，限制權(quán)限
db.createUser({
user: 'yapi',
pwd: 'yapi',
roles: [
{ role: "dbAdmin", db: "yapi" },
{ role: "readWrite", db: "yapi" }
]
});
# 退出 Mongo Cli
exit
# 退出容器
Ctrl+P+Q
四、運(yùn)行yapi
1、搭建掛載配置文件
mkdir -p /data/yapivim config.json{
"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"
}
}
}:wq退出
2、初始化數(shù)據(jù)庫(kù)表
docker run -d --rm \
--name yapi-init \
--link mongodb:mongo \
--net=yapi \
-v /data/yapi/config.json:/yapi/config.json \
yapipro/yapi \
server/install.js3、測(cè)試連接mongo
我們使用Navicat進(jìn)行可視化的連接 數(shù)據(jù)庫(kù)輸入：admin用戶名密碼都是剛剛配置的：yapi。
連接成功??！
4、運(yùn)行yapi
docker run -d \
--name yapi \
--link mongodb:mongo \
--restart always \
--net=yapi \
-p 3000:3000 \
-v /data/yapi/config.json:/yapi/config.json \
yapipro/yapi \
server/app.js
5、測(cè)試使用
ip:3000http://192.168.84.144:3000/。
初始化管理員賬號(hào)在上面的 config.json 配置中adminAccount初始化密碼就是：yapi.pro。
6、新建項(xiàng)目
7、獲取token
五、Idea中使用
1、下載插件
插件名稱：EasyYapi。
2、配置插件
3、測(cè)試上傳
找到controller。
選擇你要上傳的接口，點(diǎn)擊對(duì)號(hào)上傳！
填寫token。
上傳成功：
六、在線請(qǐng)求使用
1、配置地址
2、配置地址
3、安裝cross-request 插件
發(fā)送請(qǐng)求時(shí)，會(huì)提醒你安裝，你按照提示安裝下載即可！
也可以下載小編的：
鏈接：https://pan.baidu.com/s/1Bx6nGFjKsQ3ajbnLPcjsSA 提取碼：gljt。
直接解壓，拖拽到這里就行！
4、點(diǎn)擊發(fā)送
測(cè)試完成??！
七、總結(jié)
總的來(lái)說(shuō)搭建還是比較簡(jiǎn)單，集成和使用也挺好用！非常推薦哈！
當(dāng)前文章：只會(huì)使用Swagger？不妨試試YApi進(jìn)行接口文檔管理
網(wǎng)站網(wǎng)址：http://m.5511xx.com/article/ccepgcp.html
