Open API Initiative 发布 OpenAPI 规范 3.0.0

  • Shelby Switzer
  • 薛命灯

2017 年 8 月 9 日

话题:REST语言 & 开发

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

REST语言 & 开发