在 Swagger Editor 和 Swagger UI 中宣布支持 OAS 3.0

我们很高兴地宣布 Swagger UI 和 Swagger Editor 3.1.0 版本发布！这是 Swagger Editor 和 Swagger 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 Editor 和 Swagger UI。这包括新功能概述以及将在未来版本中解决的已知限制。

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

开始使用 OpenAPI 规范 3.0

为了帮助您的团队转向 OpenAPI 3.0，我们希望分享一些我们为帮助团队采用 OpenAPI 3.0 而整理的培训和文档。

• 宣布 OpenAPI 3.0 正式发布：了解 OpenAPI 3.0 的新功能，并查看最新版本对支持它的 Swagger 工具意味着什么。 了解更多
• 教程：学习新的 OpenAPI 规范：您可以在 Swagger.io 上找到 OpenAPI 3.0 和 Swagger 2.0 规范的文档。更新的文档详细介绍了 3.0 规范中更新的结构和新功能。 学习新规范。
• OpenAPI 3.0 及其对 Swagger 未来的意义 [录制网络研讨会]：在此培训中，我们探讨了 OpenAPI 3.0 的最新改进。Ron Ratovsky（Swagger 开发者推广大使，OAI TSC 成员）介绍了主要更新，例如：改进的可重用性、参数更改、内容协商支持、对描述回调、链接的支持、改进的示例以及增强的安全定义。 了解更多关于 OAS 3.0 最新功能的信息。