跳至主要内容

OAI 宣布 OpenAPI 规范 3.0.0

作者 2017 年 7 月 26 日2020 年 11 月 4 日博客

Open API Initiative (OAI) 是一个 Linux 基金会项目,旨在推动 API 技术发展,该项目宣布发布 OpenAPI 规范 3.0.0 版本。OAI 为开发 API 和其他技术的互操作性提供基础。

OpenAPI 规范 (OAS) v3 版本是来自多个行业(如支付和银行、云计算、物联网以及构建 API 解决方案的供应商)的高级 API 开发人员和架构师之间近两年合作的成果。在 OAI 的指导下,这种合作提供了一种通用方式来统一行业定义和描述 API 的方式——这些服务是当今互联世界中应用程序相互通信的基础。OpenAPI 规范定义了 RESTful API 的接口,描述了资源和操作,以一种易于被机器和人类发现和理解的格式。

“第三代格式的发布是我们社区的一个重要里程碑,”SmartBear 软件首席技术官兼 OAI 董事会主席 Ole Lensmar 说。“做出的更新完全是用户和使用驱动的,这在规范的成功中发挥了巨大作用。该版本最强大的功能之一是其推动整个 API 生命周期的能力。”

新版 3.0 版本的主要改进包括支持描述回调、表达操作之间关系的链接、webhook、增强的示例、改进的参数描述以及更好的多部分文档处理。其他功能添加了对模板化服务器 URL 和语义版本控制的支持。详细列表请见:OpenAPI 规范 v3

“我们很高兴看到共同的 OAI 规范的采用和验证不断增长,仅在过去 18 个月内,会员公司就增长了近 4 倍,而且来自政府以及医疗保健和金融科技领域的兴趣也在不断增加,”Linux 基金会执行董事 Jim Zemlin 说。“这种增长验证了社区以开放方式使用 API 分享数据的愿景。”

API 已从开发技术发展成为业务驱动因素,对技术创新和现代化至关重要。根据 ProgrammableWeb 的数据,自 2005 年以来,已发布了近 18,000 个公共 API,仅在 2017 年最后一个季度就增加了近 1,000 个。Open API Initiative 成立于 2015 年,在过去 18 个月内已增加到 27 个成员,并且继续加速发展,超越了 API 供应商,包括来自银行、医疗保健和全球政府的领导者。

OAI 的行业支持

42Crunch
“42Crunch 很荣幸能成为 Open API Initiative 的一部分,”42Crunch 首席创新官 Philippe Leothaud 说。“OpenAPI 规范是开源的、平台无关的、供应商无关的且可扩展的。利用这种事实上的标准将加速 API 在所有行业垂直领域的采用,特别是帮助从应用程序和设备自动使用 API。”

Hart
“医疗保健行业正在经历数据革命,API 处于议程的首位,”Hart 总裁 Mohamed Alkady 说。“通过就通用 API 结构达成一致,任何人都可以快速帮助构建这种未来,而无需每次都重新学习新的命名法。随着 OAS3 的发布,我们正在接近一个更完善的结构,该结构可以更广泛地使用和部署。我们相信 Open API Initiative 和联合技术将引领 API 开发的下一代变革,我们很高兴推动这一举措在医疗保健领域的进步。”

IBM
“OAI 相对快速地发展了这一规范,IBM 认知云和 API 经济团队已准备好拥抱这一新的开放规范”,IBM 数字业务部门开放技术副总裁 Todd Moore 说。“通过帮助建立 OAI,IBM 与其他公司携手,这些公司都认识到,企业系统的强大、可扩展且安全的 API 是现代数字生态系统的基础。此外,当今的软件开发人员希望使用开放工具来帮助他们快速且一致地创建 API,以加速业务转型。我们的客户信任 IBM 来帮助他们管理整个 API 管理生命周期。”

Kong (Mashape)
“Kong 是世界上最流行的开源 API 网关,我们已经看到了 OpenAPI 规范使用量的惊人增长,”Kong (Mashape) 首席技术官兼联合创始人 Marco Palladino 说。“API 规范是现代 API 开发、发布和使用工作流程的重要组成部分——Open API Initiative 一直不懈地推进业界领先的 OpenAPI 规范格式,使其达到里程碑式的 3.0.0 版本。我们很高兴继续为围绕 OAS 的工具生态系统做出贡献。”

微软
“微软祝贺 Open API Initiative 及其开发人员发布 OpenAPI 规范的第三版,”Azure 开发人员体验高级产品经理 Kamaljit Bath 说。“我们在公司内部使用 OpenAPI,包括:用于描述 Azure API 并使用 AutoRest 工具生成客户端库,用于描述与 Azure LogicApps/Microsoft Flow 集成的 150 多项服务,用于客户描述他们正在引入 Azure API Management 服务的 API,以及用于描述 API 的描述,我们生成这些 API 的文档并托管在 https://docs.microsoft.com/ 和 https://apidocs.microsoft.com/ 上。我们期待最新版本以及它带来的作者、维护和使用 OpenAPI 描述的改进。”

MuleSoft
“OpenAPI 规范 (OAS) 的新版本在更完整地描述 API 方面取得了重要进展,”MuleSoft 首席技术官 Uri Sarid 说。“API 规范对于启用强大、高效且快速增长的业务能力市场至关重要。这些市场反过来又成为企业、政府和整个行业的数字化转型的核心。OAS 版本 3 提供了描述 API 的广泛格式,RAML 提供了建模 API 的强大格式,API 建模框架利用两者来提供可重用性和一致性,以及用于构建 API 工具的通用 SDK。我们期待继续投资于这些工具,并推动 OAI 标准发展,为 API 生态系统创造价值。”

红帽
“红帽是开源标准和开源的坚定支持者,”红帽公司高级主管兼 API 管理主管 Steven Willmott 说。“Open API Initiative 的进展以及这次发布展示了社区力量的强大之处,我们很高兴看到行业围绕一个强大的通用标准团结起来。”

SmartBear
“SmartBear 是开源社区的坚定支持者,2015 年将原始 Swagger 规范捐赠给了 OAI。规范的演变显示了将来自不同行业的协作者汇集在一起的力量,以便以开放和透明的方式使规范发展,以满足世界各地 API 开发人员和使用者的需求,”SmartBear Swagger 开发人员布道者 Ron Ratovsky 说。“SmartBear 致力于使用我们的开源 Swagger 工具和我们的集成平台 SwaggerHub 支持 OAS 3.0。”

Tyk Technologies
“越来越多的客户采用 OpenAPI 规范作为事实上的 API 描述格式,”Tyk Technologies 首席执行官兼创始人 Martin Buhr 说。“作为领先的开源 API 管理平台,Tyk 致力于开源和开放标准,我们很高兴能够参与 OAS v3.0 规范的发布。”

OAI 的现有成员包括:42Crunch、Adobe Systems, Inc.、API Evangelist、Atlassian、CA Incorporated、Capital One、Cloud Elements、Finxact, LLC、Google, Inc.、Hart、IBM、Intento, Inc.、ISA Research Group、Mashape Inc.、Microsoft Corporation、MuleSoft、Oracle Apiary、Red Hat、RepreZen、Restlet, Inc.、Salesforce、Samsung ARTIK Cloud、SmartBear Software、Software AG、StopLight 和 Tyk。

OpenAPI 是 Swagger 规范的演进版本,该规范由 SmartBear 于 2015 年捐赠给 Linux 基金会。如需详细了解 OpenAPI 规范,并了解会员资格和贡献信息,请访问:https://www.openapis.org.cn/

资源

OpenAPI 规范 v3
在 Twitter 上关注 OAI @OpenApiSpec 或加入 GitHub 上的讨论 GitHub

关于 Open API Initiative
Open API Initiative (OAI) 由一群具有前瞻性的行业专家创建,他们认识到标准化 REST API 描述方式的巨大价值。作为 Linux 基金会下的一个开放治理结构,OAI 专注于创建、发展和推广供应商中立的描述格式。访问 https://www.openapis.org.cn/ 以获取更多信息。

###

Linux 基金会已注册商标并使用商标。有关 Linux 基金会的商标列表,请参阅其商标使用页面:https://www.linuxfoundation.org/trademark-usage。Linux 是 Linus Torvalds 的注册商标。