Centos Swagger如何自定義接口文檔

在CentOS上自定義Swagger接口文檔，通常涉及到以下幾個步驟：

1. 安裝Swagger工具： 首先，你需要確保你的CentOS系統上已經安裝了Swagger工具。你可以使用pip來安裝Swagger UI或者Swagger Editor。

   pip install swagger-ui-express
   

   或者安裝Swagger Editor：

   pip install swagger-editor
   

2. 創建Swagger配置文件： 創建一個YAML或JSON格式的Swagger配置文件，這個文件定義了你的API接口和文檔。例如，創建一個名為swagger.yaml的文件，并填入你的API信息。

   swagger: '2.0'
   info:
     title: Sample API
     description: A sample API to demonstrate Swagger customization
     version: 1.0.0
   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
   

3. 集成Swagger到你的應用： 如果你使用的是Express框架，你可以使用swagger-ui-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.listen(3000, () => {
     console.log('Server is running on port 3000');
   });
   

4. 自定義Swagger UI： Swagger UI提供了一些選項來自定義界面，例如更改主題、添加自定義CSS/JS等。你可以在swaggerUi.setup()函數中傳入一個配置對象來自定義Swagger UI。

   const ui = swaggerUi.serve({
     url: '/api-docs/swagger.json',
     deepLinking: true,
     presets: [
       swaggerUi.presets.apis,
       swaggerUi.presets.promises
     ],
     plugins: [
       swaggerUi.plugins.DownloadUrl
     ],
     layout: "StandaloneLayout"
   }, (req, res) => {
     res.setHeader('Content-Type', 'text/html');
     res.write('<style>/* Your custom CSS here */</style>');
     res.end();
   });
   

5. 運行你的應用： 運行你的Node.js應用，訪問http://localhost:3000/api-docs，你應該能夠看到自定義后的Swagger UI界面。

請注意，上述步驟假設你已經有了一個Node.js應用。如果你使用的是其他語言或框架，步驟可能會有所不同。此外，確保你的CentOS系統上已經安裝了Node.js和npm。如果還沒有安裝，可以通過以下命令安裝：

sudo yum install nodejs npm

以上步驟應該可以幫助你在CentOS上自定義Swagger接口文檔。如果你需要更高級的自定義，可能需要深入了解Swagger工具的文檔和API。