ASP.NET Core 使用Swagger/OpenAPI文档化API

为了了解什么是Swagger以及OpenAPI，在本节开始之前，我们通过一个故事介绍一下Swagger的来源：Swagger项目的来源可以追溯到2011年，由大名鼎鼎Wordnik字典站点(https://www.wordnik.com/)的技术联合创始人Tony Tam创建，在Wordnik产品的开发过程中，他们遇到了自动化API文档和客户端SDK生成的需求，这成为一个主要的挑战，为了解决这个问题，Tony Tam设计了一种简单的JSON表示方式，利用了HTTP协议的灵活性，并借鉴了为SOAP协议构建的一些工具的特性

在这个过程中，团队逐渐形成了Swagger项目，并于2011年9月将其开源，这个项目的初衷是为了提供一种简便的方式来描述、文档化和消费RESTful API，在Swagger的早期阶段，它获得了一些小公司和独立开发者的关注，因为HTTP API通常没有一个可机器读取的描述机制，而Swagger提供了一个相对简单和易于理解的方法

由于Swagger的成功，它在API行业中逐渐引起了更广泛的关注。在2015年11月，SmartBear Software公司（当时Swagger的维护者）宣布帮助创建一个新的组织，即OpenAPI Initiative，由Linux基金会赞助。这标志着Swagger的演进，而Swagger规范最终更名为OpenAPI规范

整个Swagger项目的发展源于对API文档和开发工具的实际需求，旨在简化API的设计、文档化和消费过程

简而言之：

• OpenAPI 是Swagger项目发展中形成的一种规范+ Swagger项目在整个过程中也符合OpenAPI规范的工具集，例如 OpenAPIGenerator 和 SwaggerUI