OpenAPI Initiative (OAI) 是一个 Linux 基金会项目,旨在推进 API 技术,它宣布发布 OpenAPI 规范 3.0.0 版本。OAI 为开发 API 和其他技术的互操作性奠定了基础。
OpenAPI 规范 (OAS) v3 版本是来自多个行业(如支付和银行、云计算、物联网以及构建 API 解决方案的供应商)的资深 API 开发人员和架构师近两年协作的成果。在 OAI 的指导下,这种协作提供了一种统一行业如何定义和描述 API 的通用方法——这些服务是当今互联世界中应用程序相互通信的基础。OpenAPI 规范定义了 RESTful API 的接口,以一种易于被机器和人类发现和理解的格式描述资源和操作。
“第三代格式的发布是我们社区的一个重要里程碑,”SmartBear Software 首席技术官兼 OAI 董事会主席 Ole Lensmar 表示。“所做的更新完全以用户和使用为导向,这在规范的成功中发挥着巨大作用。此版本最强大的功能之一是其推动整个 API 生命周期的能力。”
新版本 3 中的主要改进包括支持描述回调、表达操作之间关系的链接、Webhook、增强的示例、改进的参数描述以及更好的多部分文档处理。其他功能增加了对模板化服务器 URL 和语义版本控制的支持。此处提供了详细列表:OpenAPI 规范 v3
“我们很高兴看到通用 OAI 规范的采用和验证在增长,仅在过去 18 个月里,成员公司数量就增长了近 4 倍,并且政府以及医疗保健和金融科技行业的兴趣也在不断增加,”Linux 基金会执行董事 Jim Zemlin 表示。“这种增长证明了社区通过 API 共享数据的开放方式的愿景。”
API 已从开发技术提升为业务驱动力,是技术创新和现代化的必要条件。根据 ProgrammableWeb 的数据,自 2005 年以来,已发布了近 18,000 个公共 API,仅在 2017 年最后一个季度就增加了近 1,000 个。OpenAPI Initiative 成立于 2015 年,在过去的 18 个月里成员数量已增至 27 个,并且继续加速发展,超越 API 供应商,包括来自银行、医疗保健和全球政府的领导者。
行业对 OAI 的支持
42Crunch
“42Crunch 很荣幸能成为 OpenAPI Initiative 的一部分,”42Crunch 首席创新官 Philippe Leothaud 表示。“OpenAPI 规范是开源的、平台无关的、供应商无关的且可扩展的。利用这种事实上的标准将加速 API 在所有行业领域的采用,尤其是帮助应用程序和设备自动使用 API。”
Hart
“医疗保健领域目前正在经历一场数据革命,API 处于议程的首位,”Hart 总裁 Mohamed Alkady 表示。“通过就通用 API 结构达成一致,使任何人都可以快速帮助构建这个未来,而无需每次都重新学习新的命名法。随着 OAS3 的发布,我们正朝着更完善的结构迈进,该结构可以更广泛地使用和部署。我们相信 OpenAPI 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 开发、发布和使用工作流程的关键部分——OpenAPI Initiative 一直不懈地将行业领先的 OpenAPI 规范格式推进到其里程碑式的 3.0.0 版本。我们很高兴继续为 OAS 周围的工具生态系统做出贡献。”
Microsoft
“Microsoft 祝贺 OpenAPI Initiative 及其开发人员发布 OpenAPI 规范的第三版,”Azure 开发者体验首席项目经理 Kamaljit Bath 表示。“我们在整个公司中使用 OpenAPI,包括:用于描述 Azure API 并使用 AutoRest 工具生成客户端库,用于描述与 Azure LogicApps/Microsoft Flow 集成的 150 多项服务,用于客户描述他们引入 Azure API Management 服务的 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 生态系统创造价值。”
Red Hat
“Red Hat 坚定地支持开放标准和开源,”Red Hat Inc. API 管理高级总监兼负责人 Steven Willmott 表示。“OpenAPI Initiative 的进步以及此版本展示了社区的力量,我们很高兴看到行业围绕强大的通用标准形成共识。”
SmartBear
“SmartBear 是开源社区的坚定支持者,在 2015 年将原始的 Swagger 规范捐赠给了 OAI。规范的演变表明,将来自各行业的合作者聚集在一起以开放透明的方式发展规范以满足全球 API 开发人员和消费者的需求的力量,”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 规范的演进版本,Swagger 规范于 2015 年由 SmartBear 捐赠给 Linux 基金会。要了解更多关于 OpenAPI 规范的信息,并了解会员资格和贡献,请访问:https://www.openapis.org.cn/
资源
OpenAPI 规范 v3
在 Twitter 上关注 OAI @OpenApiSpec 或在 GitHub 上加入讨论
关于 OpenAPI Initiative
OpenAPI Initiative (OAI) 由一群具有前瞻性的行业专家创建,他们认识到标准化 REST API 描述方式的巨大价值。作为 Linux 基金会下的一个开放治理结构,OAI 专注于创建、发展和推广一种供应商中立的描述格式。访问 https://www.openapis.org.cn/ 获取更多信息。
###
Linux 基金会已注册商标并使用商标。有关 Linux 基金会商标列表,请参阅其商标使用页面:https://www.linuxfoundation.org/trademark-usage。Linux 是 Linus Torvalds 的注册商标。