2018 年 OpenAPI 3.0 入门 10 大资源

  2017 年 12 月 20 日

2017 年标志着 OpenAPI 规范最新版本 OpenAPI 3.0 的正式发布。

这是自 2015 年该规范捐赠给 OpenAPI 倡议以来首次重大发布。该版本的发布标志着 API 描述格式的演变以及它们在帮助团队开发出色 API 中的作用的一个重要里程碑。

自 OpenAPI 3.0 发布以来,Swagger 团队一直在努力推出新资源,以帮助团队开始使用最新版本的 OpenAPI。我们在两个主要的开源 Swagger 项目中发布了对 OAS 3.0 的初步支持—— Swagger-UI 和 Swagger-Editor,并且还发布了在 SwaggerHub 中设计、记录和将 API 转换为 OpenAPI 3.0 的支持。

在 2018 年,我们预计会在整个 API 领域看到更多工具添加对 OAS 3.0 的支持。自正式发布以来,我们有机会参加 APIStrat 2017 和 AWS re:Invent 等行业活动,我们在活动中听取了数百位 API 从业者的意见,他们希望将 OAS 3.0 应用于设计和记录 API 之外,还应用于测试和部署到 API 网关。

为了帮助您的团队切换到 OpenAPI 3.0,我们想分享一些我们整理的培训和文档,以帮助团队采用 OpenAPI 3.0。

宣布正式发布 OpenAPI 3.0

了解 OpenAPI 3.0 中的新功能,并了解最新版本对支持它的 Swagger 工具的意义。

了解更多

产品更新:使用 OpenAPI 3.0 设计和记录 API

SwaggerHub 是首批提供对 OpenAPI 3.0 支持的 API 设计和文档平台之一。您还可以将现有的 2.0 规范转换为最新版本的 OpenAPI。了解如何在 SwaggerHub 中开始使用 OpenAPI 3.0。

了解有关 SwaggerHub 中 OAS 3.0 支持的更多信息。

教程:学习新的 OpenAPI 规范

您可以在 Swagger.io 上找到 OpenAPI 3.0 和 Swagger 2.0 规范的文档。更新的文档详细介绍了 3.0 规范中更新的结构和新功能。

学习新的规范。

OpenAPI 3.0 及其对 Swagger 未来的意义 [录制的网络研讨会]

在本培训中,我们将了解 OpenAPI 3.0 的最新改进。Swagger 开发者布道师和 OAI TSC 成员 Ron Ratovsky 介绍了主要更新,例如:改进的可重用性、参数更改、内容协商支持、描述回调的支持、链接、改进的示例和增强的安全性定义。

了解有关 OAS 3.0 中最新功能的更多信息。

OpenAPI 3.0:如何使用最新的 OpenAPI 规范设计和记录 API [录制的网络研讨会]

本培训提供了在 SwaggerHub 中使用 OpenAPI 3.0 定义新 API 的现场演示。了解 OpenAPI 的新结构,并观看演示如何使用 SwaggerHub 编辑器使用 OpenAPI 3.0 定义和可视化 API 文档的现场演示。

了解有关使用 OAS 3.0 设计和记录 API 的更多信息。

Swagger 和 OpenAPI 之间有什么区别?

OpenAPI 是该规范的正式名称。该规范的开发由 OpenAPI 倡议促进,该倡议涉及来自技术领域不同领域的 30 多个组织,包括 Microsoft、Google、IBM 和 CapitalOne。领导 Swagger 工具开发的 Smartbear Software 公司也是 OpenAPI 倡议的成员,帮助领导该规范的演变。

了解有关 OpenAPI 和 Swagger 之间差异的更多信息。

OpenAPI 规范的状态:与 OAI TSC 的 Darrel Miller 的对话

SmartBear 的 Swagger/SwaggerHub 产品营销经理 Keshav Vasudevan 在 APIStrat 2017 上与 OAI 技术指导委员会 (TSC) 的 Darrel Miller 进行了对话,讨论了 OpenAPI 的最新进展以及该项目的当前状态。

阅读完整对话。

其他资源

自 OpenAPI 3.0 发布以来,整个 API 领域发布了许多有价值的资源,以帮助团队学习和采用新的 OpenAPI 3.0 规范。以下是我们从其他 API 组织和从业者那里获得的一些最爱

准备好开始使用 OpenAPI 3.0 了吗? 了解有关 SwaggerHub 中 OAS 3.0 支持的更多信息