ubuntu中如何調試swagger接口

在Ubuntu系統中調試Swagger接口，你可以遵循以下步驟：

1. 安裝Swagger UI：首先，你需要在你的Ubuntu系統上安裝Swagger UI。你可以使用npm（Node.js包管理器）來安裝它。如果你還沒有安裝Node.js，請先安裝它。打開終端，然后運行以下命令：

sudo apt update
sudo apt install nodejs npm

接下來，使用npm全局安裝Swagger UI：

sudo npm install -g swagger-ui-express

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

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

const app = express();

// 讀取Swagger文檔
const swaggerDocument = YAML.load('./swagger.yaml');

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

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

3. 創建Swagger文檔：在項目文件夾中創建一個名為swagger.yaml的文件，并添加你的API接口定義。例如：

swagger: '2.0'
info:
  title: Sample API
  description: A sample API to demonstrate Swagger UI.
  version: '1.0.0'
host: localhost:3000
basePath: /api-docs
schemes:
  - http
paths:
  /users:
    get:
      summary: List all users
      responses:
        200:
          description: An array of users
          schema:
            type: array
            items:
              $ref: '#/definitions/User'
definitions:
  User:
    type: object
    properties:
      id:
        type: integer
        format: int64
      name:
        type: string
      email:
        type: string
        format: email

4. 運行應用：在終端中，導航到項目文件夾并運行以下命令：

node app.js

5. 訪問Swagger UI：在瀏覽器中訪問http://localhost:3000/api-docs，你應該能看到Swagger UI界面，其中列出了你在swagger.yaml文件中定義的所有API接口。你可以在這里測試和調試你的接口。

注意：這里的示例使用了Express框架和YAML格式的Swagger文檔。你也可以使用其他編程語言和文檔格式，例如OpenAPI 3.0和JSON格式。只需相應地調整安裝依賴項和代碼即可。