宣布 Swagger Editor 和 Swagger UI 支持 OAS 3.0

  2017 年 8 月 3 日

我们很高兴地宣布 Swagger UI 和 Swagger Editor 3.1.0 版本发布!这是Swagger EditorSwagger UI 的第一个版本,支持新的OpenAPI 3.0 (OAS) 规范

OAS 3.0 基于 Swagger 2.0 规范,增加了重大改进和新功能,包括:更高的可重用性、扩展的 JSON Schema 功能以及增强的安全性定义。

Swagger UI 和 Swagger Editor 是使用 OpenAPI 规范设计和记录 RESTful API 的最广泛使用的工具之一。 此最新版本使用户可以使用 Swagger Editor 来描述 OAS 3.0 API,并使用 Swagger UI 来可视化并自动生成以 OAS 3.0 定义的 API 文档。

这是第一个支持 OAS 3.0 的版本,我们将发布其他更新以扩展对 OAS 3.0 的支持。

您可以在 GitHub 上阅读此版本的完整发行说明:Swagger EditorSwagger UI。 这包括对新功能的概述,以及将在未来版本中解决的已知限制。

作为一个开源项目,该团队依靠社区反馈来改进工具。我们邀请您在项目存储库中提交工单来分享您的反馈。

开始使用 OpenAPI 规范 3.0

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