Ubuntu Swagger如何安裝與配置

在Ubuntu上安裝和配置Swagger，通常是指安裝Swagger UI和Swagger Editor。以下是詳細的步驟：

安裝Node.js和npm

首先，你需要在Ubuntu上安裝Node.js和npm。你可以通過以下命令來安裝：

sudo apt update
sudo apt install -y nodejs npm

安裝Swagger Editor

1. 下載Swagger Editor：

   訪問Swagger Editor的GitHub發布頁面，下載最新版本的Swagger Editor。

2. 解壓并啟動Swagger Editor：

   wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
   tar -xvf v3.16.1.tar.gz
   cd swagger-editor-3.16.1
   npm install
   npm install -g http-server
   

3. 啟動Swagger Editor：

   http-server -p 8080
   

   現在，你可以在瀏覽器中訪問 http://localhost:8080 來使用Swagger Editor。

安裝Swagger UI

1. 下載Swagger UI：

   訪問Swagger UI的GitHub發布頁面，下載最新版本的Swagger UI。

2. 解壓并啟動Swagger UI：

   wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.48.0.tar.gz
   tar -xvf v3.48.0.tar.gz
   cd swagger-ui-3.48.0
   npm install
   npm install -g http-server
   

3. 啟動Swagger UI：

   http-server -p 8081
   

   現在，你可以在瀏覽器中訪問 http://localhost:8081 來使用Swagger UI。

配置Swagger Editor和Swagger UI

• Swagger Editor：默認情況下，Swagger Editor會加載 https://petstore.swagger.io/v2/swagger.json。你可以通過編輯 index.html 文件來更改默認的Swagger規范文件路徑。

• Swagger UI：在Swagger UI中，你可以通過輸入框來輸入你的Swagger規范文件（通常是 swagger.yaml 或 swagger.json）的URL，然后點擊“Explore”按鈕來加載和測試你的API接口。

使用Swagger進行接口測試

1. 在Swagger Editor中導入Swagger規范文件：

   打開Swagger Editor后，點擊“File” - “Import” - “Open File”，然后選擇你的 swagger.yaml 或 swagger.json 文件。

2. 測試API接口：在Swagger Editor中，你可以為每個API接口生成測試用例，也可以直接調用這些接口進行測試。

3. 在Swagger UI中測試API接口：在Swagger UI中，選擇你要測試的API接口，點擊“Try it out!”按鈕，然后在彈出的對話框中輸入必要的參數，最后點擊“Execute”按鈕來測試接口。

以上步驟應該可以幫助你在Ubuntu上成功安裝和配置Swagger，并進行接口測試。如果在安裝過程中遇到問題，可以參考相關的官方文檔或社區論壇尋求幫助。