Swagger配置文件

Swagger 的配置文件是一个 JSON 或 YAML 格式的文件，可以通过编辑该文件来自定义 Swagger 的行为和样式，例如添加身份验证信息、指定 API 文档的标题、描述、版本号等。

以下是一个 Swagger 配置文件的示例：

swagger: '2.0' # Swagger 版本号
info:
  title: Sample API # API 标题
  description: This is a sample API # API 描述
  version: 1.0.0 # API 版本号
basePath: /v1 # API 基础路径
schemes:
  - https # API 协议
consumes:
  - application/json # 请求数据格式
produces:
  - application/json # 响应数据格式
securityDefinitions:
  basicAuth:
    type: basic # 身份验证类型
paths:
  /users:
    get:
      summary: Get a list of users # API 摘要
      description: Returns a list of users # API 描述
      parameters:
        - name: limit # 请求参数
          in: query
          type: integer
          description: The maximum number of items to return
      responses:
        200:
          description: A list of users
          schema:
            type: array
            items:
              $ref: '#/definitions/User'
definitions:
  User:
    type: object
    properties:
      id:
        type: integer
        format: int64
      name:
        type: string

在这个示例中，我们定义了 API 的基本信息、协议、身份验证信息、路径、请求参数、响应等信息。您可以按照自己的需求对该文件进行修改。