BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

Open API Initiative发布OpenAPI规范3.0.0

| 作者 Shelby Switzer 关注 0 他的粉丝 ,译者 薛命灯 关注 12 他的粉丝 发布于 2017年8月10日. 估计阅读时间: 3 分钟 | QCon北京2018全面起航:开启与Netflix、微软、ThoughtWorks等公司的技术创新之路!

亲爱的读者:我们最近添加了一些个人消息定制功能,您只需选择感兴趣的技术主题,即可获取重要资讯的邮件和网页通知

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

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT