swagger2和swagger3区别

### Swagger 2 和 Swagger 3 的差异

#### 版本命名变化
Swagger 3 实际上被称为 OpenAPI Specification 3 (OAS3)，这是为了更好地反映其作为开放标准的地位[^1]。

#### 改进的结构和支持更丰富的描述
OpenAPI 3 提供了一个更为清晰和模块化的架构来定义 API。它引入了 Components 部分，允许重用对象如 schemas、responses 或 parameters 等，这使得大型 API 文档更加易于管理和维护。

#### 新增功能特性
- **路径参数支持数组类型**: OAS3 扩展了对复杂数据类型的处理能力，比如现在可以直接声明路径变量为数组形式。
- **回调机制**: 可以为异步操作指定回调接口，这对于微服务架构下的事件驱动型应用尤为重要。
- **链接(Link)**: 定义资源之间关系的方式得到了增强，能够表达不同请求间的依赖逻辑。
- **安全性和授权方案多样化**: 增加了更多内置的安全模式选项，并且可以通过扩展自定义认证方式[^2].

#### 更好的工具链集成
随着版本迭代，围绕着 OAS3 构建起来的一系列开发辅助工具也日益成熟和完善，包括但不限于代码生成器、客户端库以及测试框架等，这些都极大地提高了开发者的工作效率。

# Example of a simple API definition using OAS3
openapi: "3.0.0"
info:
  title: Sample API
  description: A sample API to illustrate differences between swagger versions.
  version: 1.0.0
servers:
  - url: https://example.com/api/v1
paths:
  /users/{id}:
    get:
      summary: Get user by ID
      operationId: getUserById
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
        username:
          type: string