Yapi搭建全面指南

一、Yapi是什麼？

Yapi是一個開源的API管理平台，支持介面管理、測試、Mock、文檔等功能。

搭建Yapi可以讓團隊更方便地管理API介面，提高開發效率。

二、Yapi搭建前的準備工作

1、安裝Node.js

Yapi是基於Node.js開發的，因此需要在安裝之前安裝好Node.js。

sudo apt-get install nodejs
sudo apt-get install npm

2、安裝MongoDB

Yapi使用MongoDB作為資料庫，因此需要事先安裝。

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10
echo "deb http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list
sudo apt-get update
sudo apt-get install mongodb-org
sudo systemctl enable mongod

3、安裝Yapi

可以通過npm全局安裝Yapi。

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

4、配置Yapi

使用yapi命令初始化項目。

yapi server

按照提示進行配置，配置完成之後，Yapi就可以正常使用了。

三、Yapi的使用

1、創建項目

通過Yapi可以創建多個項目，每個項目可以包含多個介面。

進入Yapi的管理界面，在左側導航欄中找到「項目」，點擊「+」按鈕，輸入項目名稱、描述等信息，就可以創建一個新的項目。

2、創建介面

在項目中創建介面，可以通過導入Swagger文件、手動添加等方式。

手動添加介面時，需要填寫介面名稱、請求方式、請求路徑等信息，還可以添加請求參數、響應參數等詳細信息。

3、Mock數據

為了方便前端開發，Yapi還提供了Mock數據功能，可以快速生成測試數據，方便調試前端頁面。

在介面詳情頁面中，點擊「Mock數據」按鈕，就可以生成Mock數據。

4、介面測試

在Yapi中可以進行介面測試，可以輸入請求參數，進行介面測試。

在介面詳情頁面中，點擊「測試」按鈕，就可以進行介面測試。

5、文檔生成

Yapi還可以根據介面信息生成文檔，方便其他開發人員進行介面調用。

在介面詳情頁面中，點擊「文檔」按鈕，就可以生成文檔。

四、Yapi的高級使用

1、數據導入導出

Yapi可以導入Swagger文件、導出數據到本地文件，方便數據備份和遷移。

在管理界面中，可以通過「數據備份/恢復」菜單進行數據導入導出。

2、許可權管理

Yapi支持多用戶操作，可以通過許可權管理，控制每個用戶對項目的操作許可權。

在管理界面中，可以通過「用戶」菜單進行用戶管理。

3、自定義Mock數據

Yapi支持自定義Mock數據，可以根據需要自定義Mock數據的生成規則，方便測試和調試。

在管理界面中，可以通過「全局配置」菜單進行自定義Mock數據的設置。

4、介面聯調

Yapi支持介面聯調，可以檢查介面返回數據和預期結果是否一致，方便排查介面問題。

在介面詳情頁面中，點擊「聯調」按鈕，可以進行介面聯調。

總結

Yapi是一個功能強大的API管理平台，可以幫助團隊更方便地管理介面，提高工作效率。

在使用中需要注意許可權管理和數據備份，避免數據丟失和誤操作。