如何在Linux上實現Swagger API版本管理

在Linux上實現Swagger API版本管理，可以遵循以下步驟：

1. 安裝Swagger工具

首先，確保你的Linux系統上已經安裝了Swagger工具。你可以使用npm（Node.js的包管理器）來安裝Swagger。

sudo npm install -g swagger-ui-express

2. 創建Swagger配置文件

在你的項目中創建一個Swagger配置文件，通常命名為swagger.json或swagger.yaml。以下是一個簡單的swagger.yaml示例：

swagger: '2.0'
info:
  title: Sample API
  description: A sample API to demonstrate Swagger
  version: '1.0.0'
host: localhost:3000
basePath: /
schemes:
  - http
paths:
  /api/v1/hello:
    get:
      summary: Get a hello message
      responses:
        '200':
          description: A successful response
          schema:
            type: string

3. 集成Swagger到你的應用

在你的Express應用中集成Swagger。以下是一個簡單的Express應用示例，展示了如何集成Swagger UI：

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

const swaggerDocument = YAML.load('./swagger.yaml');

const app = express();

app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));

app.get('/api/v1/hello', (req, res) => {
  res.send('Hello, World!');
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

4. 版本管理

為了實現API版本管理，你可以在Swagger配置文件中使用不同的路徑或標簽來區分不同版本的API。例如：

swagger: '2.0'
info:
  title: Sample API
  description: A sample API to demonstrate Swagger
  version: '1.0.0'
host: localhost:3000
basePath: /
schemes:
  - http
paths:
  /api/v1/hello:
    get:
      summary: Get a hello message for version 1
      responses:
        '200':
          description: A successful response
          schema:
            type: string
  /api/v2/hello:
    get:
      summary: Get a hello message for version 2
      responses:
        '200':
          description: A successful response
          schema:
            type: string

5. 更新Swagger文檔

每次更新API時，記得更新Swagger配置文件，并重新啟動你的應用以使更改生效。

6. 使用Swagger Editor

你可以使用Swagger Editor來在線編輯和預覽你的Swagger文檔。訪問Swagger Editor，將你的swagger.yaml文件粘貼進去，即可實時查看和測試你的API文檔。

通過以上步驟，你可以在Linux上實現Swagger API版本管理。這樣可以幫助你更好地組織和維護不同版本的API文檔。