[关闭]
@babydragon 2017-11-10T14:36:52.000000Z 字数 851 阅读 1137

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。不论名称如何改变,规范还是那个规范。

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注