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 中的新功能,并了解最新版本对支持它的 Swagger 工具的意义。
了解更多
SwaggerHub 是首批提供对 OpenAPI 3.0 支持的 API 设计和文档平台之一。您还可以将现有的 2.0 规范转换为最新版本的 OpenAPI。了解如何在 SwaggerHub 中开始使用 OpenAPI 3.0。
了解有关 SwaggerHub 中 OAS 3.0 支持的更多信息。
您可以在 Swagger.io 上找到 OpenAPI 3.0 和 Swagger 2.0 规范的文档。更新的文档详细介绍了 3.0 规范中更新的结构和新功能。
学习新的规范。
在本培训中,我们将了解 OpenAPI 3.0 的最新改进。Swagger 开发者布道师和 OAI TSC 成员 Ron Ratovsky 介绍了主要更新,例如:改进的可重用性、参数更改、内容协商支持、描述回调的支持、链接、改进的示例和增强的安全性定义。
了解有关 OAS 3.0 中最新功能的更多信息。
本培训提供了在 SwaggerHub 中使用 OpenAPI 3.0 定义新 API 的现场演示。了解 OpenAPI 的新结构,并观看演示如何使用 SwaggerHub 编辑器使用 OpenAPI 3.0 定义和可视化 API 文档的现场演示。
了解有关使用 OAS 3.0 设计和记录 API 的更多信息。
OpenAPI 是该规范的正式名称。该规范的开发由 OpenAPI 倡议促进,该倡议涉及来自技术领域不同领域的 30 多个组织,包括 Microsoft、Google、IBM 和 CapitalOne。领导 Swagger 工具开发的 Smartbear Software 公司也是 OpenAPI 倡议的成员,帮助领导该规范的演变。
了解有关 OpenAPI 和 Swagger 之间差异的更多信息。
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 支持的更多信息。