2017年标志着OpenAPI规范最新版本OpenAPI 3.0的正式发布。
这是自2015年该规范捐赠给OpenAPI Initiative以来的首次重大发布。此次发布标志着API描述格式演进及其在帮助团队开发优秀API方面所起作用的重要里程碑。
自OpenAPI 3.0发布以来,Swagger团队一直致力于推出新资源,以帮助团队开始使用最新版本的OpenAPI。我们在两个主要的开源Swagger项目中——Swagger-UI和Swagger-Editor中发布了对OAS 3.0的初步支持,并在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 Initiative推动,该组织汇集了来自科技界不同领域的30多个组织,包括微软、谷歌、IBM和CapitalOne。Smartbear Software作为领导Swagger工具开发的公司,也是OpenAPI Initiative的成员,帮助引领规范的演进。
了解更多关于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支持的信息。