CentOS Swagger API文档怎么写

在CentOS系统上编写Swagger API文档，通常涉及以下几个步骤：

1. 安装Swagger工具

首先，你需要安装Swagger工具。常用的Swagger工具包括Swagger Editor和Swagger UI。

使用Swagger Editor

Swagger Editor是一个在线的Swagger文档编辑器，你可以直接在浏览器中使用。

打开浏览器，访问 Swagger Editor。
在编辑器中创建一个新的Swagger文档（通常是swagger.yaml或swagger.json）。

使用Swagger UI

Swagger UI是一个用于展示和测试API文档的工具。

安装Swagger UI：
```
sudo yum install swagger-ui
```
启动Swagger UI：
```
swagger-ui
```

2. 编写Swagger文档

你可以手动编写Swagger文档，或者使用Swagger Codegen自动生成。

手动编写Swagger文档

在Swagger Editor中，你可以手动编写Swagger文档。以下是一个简单的示例：

swagger: '2.0'
info:
  title: Sample API
  description: A sample API to demonstrate Swagger documentation.
  version: '1.0.0'
host: api.example.com
basePath: /v1
schemes:
  - https
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

使用Swagger Codegen

Swagger Codegen可以根据Swagger文档自动生成客户端代码、API服务器代码等。

安装Swagger Codegen：

sudo yum install java-1.8.0-openjdk-devel
wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.21/swagger-codegen-cli-2.4.21.jar
sudo mv swagger-codegen-cli-2.4.21.jar /usr/local/bin/swagger-codegen
sudo chmod +x /usr/local/bin/swagger-codegen

生成客户端代码：

swagger-codegen generate -i swagger.yaml -l java -o /path/to/output

3. 集成Swagger到你的API

如果你使用的是Spring Boot，可以集成Springfox来生成Swagger文档。

添加依赖：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

配置Swagger：

import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo"))
                .paths(PathSelectors.any())
                .build();
    }
}

访问Swagger UI：启动你的Spring Boot应用后，访问 http://localhost:8080/swagger-ui.html 即可看到Swagger UI界面。

通过以上步骤，你可以在CentOS系统上编写和集成Swagger API文档。