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。