宣布 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。