Swagger成为OpenAPI规范

未分类

Swagger可以说是最流行的API工具，它包含RESTful API从设计、构建文档、验证各个阶段的工具。日前将Swagger v3.0被贡献给OpenAPI倡议，既Swagger成为OpenAPI规范。

Swagger简介

Swagger是一个强大的开源框架，它包含一系列工具以帮助设计、构建文档和验证API。Swagger框架支持多种语言，最终都会生成一个Swagger定义文件（JSON文件），然后可以通过工具可以将该文件生成API文档页面，供使用者查阅和验证。

最终通过Swagger UI组件生成的API文档页面如下图：

如果想要亲自了解下Swagger生成的文档页面，可以访问http://petstore.swagger.io/

OpenAPI和OpenAPI倡议

以下是来自http://openapis.org网站的引用：

OpenAPI倡议（Open API Initiative，OAI）是由具有前瞻性的行业专家创立，他们认识到了将REST API描述标准化带来的巨大价值。作为Linux基金会下属的开放式治理结构，OAI的重点是创建、演进和推广一个中立的描述格式。SmartBear Software公司直接将Swagger规范作为开放规范的基础捐赠给OAI。API是现代应用程序之间的粘合剂。几乎每个应用程序都使用API来连接外部数据源、第三方数据服务和其他应用程序。为API服务创建一个中立、可移植、开放的描述格式，对于加速实现真正互联世界的愿景至关重要。

由此可见，OpenAPI倡议致力于构建一套中立的描述格式，以帮助应用程序能够更好的进行交互。该目标和Swagger项目已经实现的一系列功能非常吻合。这次合并后将Swagger规范定格在了2.0版本，而对应的OpenAPI规范则是3.0版本。

当然，Swagger项目并没有消失而是被合并入了OpenAPI。Swagger项目本身仍然存在，它同时也指代了OpenAPI。不论名称如何改变，规范还是那个规范。