当前位置:新闻中心行业动态 → 正文

Open API Initiative发布OpenAPI规范3.0.0

责任编辑:editor006 作者:Shelby Switzer |来源:企业网D1Net  2017-08-10 15:48:42 本文摘自:INFOQ

Open API Initiative发布了OpenAPI规范(OAS)3.0.0版本。

历经将近两年的开发和7个月的发布流程,从2017年1月开始发表声明,到2月份发布实现草案,再到6月份公开讨论,这一版本才得以诞生。InfoQ之前报导过OAS 3.0的关键新特性,包括支持回调、多主机、改进的JSON Schema,以及添加新的内容,如Components和Links。

社区反响热烈,Twitter上满是表达祝贺和激动心情的推文,开源和商用工具也开始大力支持OAS 3.0。3.0版本既是OAS规范的一个里程碑版本,也是Open API Initiative(OAI)的版本,OAI目前受Linux基金会监管。

OAS技术开发者社区(TDC)的Ron Ratovsky向InfoQ讲述了有关3.0版本的发展路径以及他们在发布新版本时所面临的挑战。OAS托管在GitHub上三年多了,从2014年9月开始,6个TDC成员解决并关闭了580多个问题,还有200多个尚未解决。在谈及请求的管理、讨论和优先级安排时,Ratovsky强调,在推进OAS目标时要注重广大用户的需求,即标准化和改进对REST API的描述。在这方面,他们已经在讨论支持新的协议和新的模式(如GraphQL),不过讨论的内容尚未被加入到路线图中。

OAS 3.0中包含的Links对象被称为超媒体的“nod”,是为了解决社区中广泛存在的一个问题而被加入规范的。Links对象是超媒体之外的另一个选择,它是静态的,而超媒体是动态且自文档(self-documenting)的,Ratovsky说,“我们想着该如何提供一个方案,最后我们把它定义为静态的。我们希望得到更多有关Links这一特性的反馈。我们希望能够扩展这一特性,并为超媒体带来更多的可能性。”

除了Links对象,TDC成员希望能够得到更多其他方面的反馈。与其他开源项目一样,OAS也依赖社区的支持和参与。“我们依赖社区的努力——特性请求、发表意见、拉取请求”,Ratovsky说,“我希望能够收到更多来自产品经理、QA工程师、技术作者和API生命周期相关人员的反馈。我们想知道OAS要怎样才能让他们的工作变得更美好。”

用户可以在OAS的GitHub仓库里找到如何参与项目的相关信息。SmartBear将在8月9号举办一个webinar,对实现新特性感兴趣或正在从Swagger 2.0迁移到OAS 3.0的人可以关注下。

查看英文原文:The Open API Initiative Announces the OpenAPI Specification 3.0.0

关键字:OASInitiative

本文摘自:INFOQ

x Open API Initiative发布OpenAPI规范3.0.0 扫一扫
分享本文到朋友圈
当前位置:新闻中心行业动态 → 正文

Open API Initiative发布OpenAPI规范3.0.0

责任编辑:editor006 作者:Shelby Switzer |来源:企业网D1Net  2017-08-10 15:48:42 本文摘自:INFOQ

Open API Initiative发布了OpenAPI规范(OAS)3.0.0版本。

历经将近两年的开发和7个月的发布流程,从2017年1月开始发表声明,到2月份发布实现草案,再到6月份公开讨论,这一版本才得以诞生。InfoQ之前报导过OAS 3.0的关键新特性,包括支持回调、多主机、改进的JSON Schema,以及添加新的内容,如Components和Links。

社区反响热烈,Twitter上满是表达祝贺和激动心情的推文,开源和商用工具也开始大力支持OAS 3.0。3.0版本既是OAS规范的一个里程碑版本,也是Open API Initiative(OAI)的版本,OAI目前受Linux基金会监管。

OAS技术开发者社区(TDC)的Ron Ratovsky向InfoQ讲述了有关3.0版本的发展路径以及他们在发布新版本时所面临的挑战。OAS托管在GitHub上三年多了,从2014年9月开始,6个TDC成员解决并关闭了580多个问题,还有200多个尚未解决。在谈及请求的管理、讨论和优先级安排时,Ratovsky强调,在推进OAS目标时要注重广大用户的需求,即标准化和改进对REST API的描述。在这方面,他们已经在讨论支持新的协议和新的模式(如GraphQL),不过讨论的内容尚未被加入到路线图中。

OAS 3.0中包含的Links对象被称为超媒体的“nod”,是为了解决社区中广泛存在的一个问题而被加入规范的。Links对象是超媒体之外的另一个选择,它是静态的,而超媒体是动态且自文档(self-documenting)的,Ratovsky说,“我们想着该如何提供一个方案,最后我们把它定义为静态的。我们希望得到更多有关Links这一特性的反馈。我们希望能够扩展这一特性,并为超媒体带来更多的可能性。”

除了Links对象,TDC成员希望能够得到更多其他方面的反馈。与其他开源项目一样,OAS也依赖社区的支持和参与。“我们依赖社区的努力——特性请求、发表意见、拉取请求”,Ratovsky说,“我希望能够收到更多来自产品经理、QA工程师、技术作者和API生命周期相关人员的反馈。我们想知道OAS要怎样才能让他们的工作变得更美好。”

用户可以在OAS的GitHub仓库里找到如何参与项目的相关信息。SmartBear将在8月9号举办一个webinar,对实现新特性感兴趣或正在从Swagger 2.0迁移到OAS 3.0的人可以关注下。

查看英文原文:The Open API Initiative Announces the OpenAPI Specification 3.0.0

关键字:OASInitiative

本文摘自:INFOQ

电子周刊
回到顶部

关于我们联系我们版权声明隐私条款广告服务友情链接投稿中心招贤纳士

企业网版权所有 ©2010-2024 京ICP备09108050号-6 京公网安备 11010502049343号

^