如何使用Swagger在Ubuntu上測試API

要在Ubuntu上使用Swagger測試API，請按照以下步驟操作：

1. 安裝Swagger UI：首先，您需要在Ubuntu系統上安裝Swagger UI。打開終端并運行以下命令：

sudo apt-get update
sudo apt-get install swagger-ui-express

2. 創建一個簡單的Express應用：在您的項目文件夾中創建一個名為app.js的文件，并添加以下代碼：

const express = require('express');
const swaggerUi = require('swagger-ui-express');
const YAML = require('yamljs');

const app = express();
const port = process.env.PORT || 3000;

// 讀取Swagger JSON文件
const swaggerDocument = YAML.load('./swagger.json');

// 使用swagger-ui-express中間件
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));

// 啟動服務器
app.listen(port, () => {
  console.log(`Server is running at http://localhost:${port}`);
});

3. 創建Swagger JSON文件：在項目文件夾中創建一個名為swagger.json的文件，其中包含您的API規范。例如：

{
  "swagger": "2.0",
  "info": {
    "description": "Sample API",
    "version": "1.0.0"
  },
  "basePath": "/",
  "paths": {
    "/users": {
      "get": {
        "summary": "獲取用戶列表",
        "responses": {
          "200": {
            "description": "成功獲取用戶列表"
          }
        }
      }
    }
  }
}

4. 安裝依賴項：在項目文件夾中運行以下命令，以安裝所需的依賴項：

npm init -y
npm install express yamljs

5. 運行應用：在終端中運行以下命令，啟動Express應用：

node app.js

6. 訪問Swagger UI：在瀏覽器中訪問http://localhost:3000/api-docs，您將看到Swagger UI界面，其中顯示了您的API規范。您可以在此界面上測試API端點。

注意：這只是一個簡單的示例，您可以根據需要修改Swagger JSON文件以匹配您的API規范。在實際項目中，您可能需要使用更復雜的API規范和更多的端點。