Swagger学习一

Swagger官网：https://swagger.io/

Swagger 是一个用于设计、构建、文档化和使用 RESTful API 的开源框架，它的历史可以追溯到 2010 年左右。

以下是 Swagger 的主要发展历程：

1. 起源（2010-2011）

• Swagger 最初由 Tony Tam 和他在 Wordnik 的团队开发。

• Wordnik 是一个在线词典服务，需要一个强大的工具来管理和文档化其 API。

• 为了解决 API 文档化和测试的问题，Tony Tam 创建了 Swagger 规范，并开发了相关的工具。

2. Swagger 1.0 发布（2011）

• Swagger 1.0 是第一个正式版本，提供了基本的 API 描述功能和文档生成工具。

• 它使用 JSON 格式来描述 API，并提供了一个简单的 UI 来展示 API 文档。

3. Swagger 2.0 发布（2014）

• Swagger 2.0 是一个重大更新，引入了更简洁的语法和更强大的功能。

• 它支持 YAML 格式，使得 API 描述文件更易读和易写。

• Swagger 2.0 成为当时最流行的 API 描述格式之一，被广泛用于 RESTful API 的设计和文档化。

4. OpenAPI 倡议（2015）

• 2015 年，Swagger 被捐赠给 OpenAPI Initiative（OAI），这是一个由 Linux 基金会支持的开源组织。

• Swagger 规范更名为 OpenAPI 规范（OpenAPI Specification, OAS），并成为描述 RESTful API 的行业标准。

• 这一举措使得 Swagger 更加开放和标准化，吸引了更多企业和开发者的参与。

5. OpenAPI 3.0 发布（2017）

• OpenAPI 3.0 是 OpenAPI 规范的一个重要版本，引入了许多新特性，例如：

  • 更清晰的语法结构

  • 对 Webhooks 的支持

  • 更强大的组件复用功能

• OpenAPI 3.0 进一步巩固了 Swagger 在 API 领域的地位。

6. Swagger 工具的持续发展

• Swagger 的核心工具（如 Swagger Editor、Swagger UI、Swagger Codegen）在 OpenAPI 倡议下继续发展。

• 这些工具被广泛应用于 API 设计、测试、文档化和代码生成。

7. Swagger 的商业化（SmartBear）

• 2015 年，Swagger 的主要开发团队加入了 SmartBear Software，这是一家专注于软件开发和测试工具的公司。

• SmartBear 继续维护和开发 Swagger 工具，并推出了 SwaggerHub，一个集成的 API 设计和协作平台。

8. 现状（2020 年至今）

• Swagger 和 OpenAPI 规范已经成为 RESTful API 设计和文档化的事实标准。

• 许多企业和开发者使用 Swagger 工具来管理 API 生命周期，从设计到部署。

• SwaggerHub 等商业化产品进一步扩展了 Swagger 的功能，提供了团队协作、版本控制和 API 发布等高级特性。