全新 Swagger 編輯器和 UI 終於登場!

  2017 年 3 月 20 日

Swagger 框架永遠地改變了軟體格局,允許以每一位參與生命週期的人員和機器都能理解、工作和整合的通用語言 (OpenAPI 規格) 來描述 API。

雖然規格是框架的核心,但周圍有一個完整的工具鏈,用於增強 API 開發流程。更好地實作 Swagger 框架的最受歡迎和基本工具是 Swagger 編輯器和 Swagger UI。

Swagger UI 為 OpenAPI 規格 (以前的 Swagger 規格) 賦予了生命,讓使用者能夠以易於閱讀和理解的格式來視覺化 API 並與之互動。Swagger 編輯器是另一個受歡迎的開源專案,是使用 OpenAPI 規格設計 API 的事實上的編輯器。Swagger 編輯器和 UI 一起成為設計、記錄和視覺化 RESTFul API 的標準工具。Swagger 編輯器和 UI 的組合每 3 秒就會被下載一次。

現在,在上次重大更新的兩年後,這些工具的下一個版本終於登場。

Swagger 編輯器和 UI 的新功能?

全新的 Swagger 編輯器和 UI 採納了來自開發人員社群數萬名成員的回饋意見,並且像它們的前身一樣,是完全開源的。它們將速度和可靠性帶到 API 設計和文件流程的前沿。工具的大小已縮小 80%,這使得設計具體、穩健且長期的 API 體驗更為靈活。它們還引入了擴充機制,讓使用者可以完全自訂介面,並在核心 Swagger 平台上建構自己的功能。

新的 Swagger 編輯器和 UI 已從頭開始重新設計,將程式碼合併到一個統一的程式碼庫中,這將使處理和貢獻開源專案更加容易。這種統一的體驗為開發人員和終端使用者建立了一個通用框架,以設計、工程化和使用以 OpenAPI 規格撰寫的 API。

最新版本的 Swagger 編輯器和 UI 為未來與 OpenAPI 規格 3.0的相容性奠定了基礎,該規格將在今年稍後發布。

如果您有任何疑問,可以造訪我們的常見問題解答區

特定專案的存放庫如下

Swagger-UI: https://github.com/swagger-api/swagger-ui

Swagger-Editor: https://github.com/swagger-api/swagger-editor

Swagger 團隊將在 3 月 30 日於舊金山 Mashape 總部舉行的聚會上展示新的 Swagger 編輯器和 UI。了解更多資訊。