我們很高興地宣布在 SwaggerHub 中初步支援使用 OpenAPI 規格 3.0 (OAS 3.0) 產生程式碼！
隨著越來越多的團隊從 Swagger 2.0 轉移到 OAS 3.0，OAS 3.0 的程式碼產生一直是最多人要求的功能之一。此初步版本是第一波支援的語言，包括我們最常用的伺服器存根和 SDK 選項，包括
用戶端 SDK
- html2
- java
- php
- swift3
- swift4
- typescript-angular
伺服器存根
- jaxrs-di
- jaxrs-jersey
- jaxrs-resteasy
- jaxrs-resteasy-eap
您現在可以登入，開啟新的或現有的 API 定義，並從定義編輯器右上角的「匯出」選單存取程式碼產生選項。
結合 SwaggerHub 中從 2.0 遷移到 3.0 的強大轉換功能，或將這些 SDK 輕鬆推送到您選擇的儲存庫系統的能力 — 我們現在讓團隊更容易在 OAS 3.0 上標準化，並充分利用最新版本 OpenAPI 規格的功能。除了支援 OAS 3.0 程式碼產生之外，團隊還進行了一些新增功能以增強平台的使用性。
自訂您的編輯器體驗
我們收到許多用戶的回饋，他們希望能夠自訂 SwaggerHub 編輯器以獲得更好的設計體驗。編輯器進行了一些調整，以支援更好的可讀性 — 從可變的字型大小到更廣泛的調色板選項。
我們也進行了一些幕後調整，以解決使用者提出的一些效能問題。
評論的直觀通知
評論可用於溝通變更，並追蹤整個設計和審閱過程中的問題。
對評論引入的一項小改進是，使用者現在可以看到有多少請求正在等待解決。您現在可以一目瞭然地看到未解決評論的數量，而不必搜尋問題以了解已解決哪些評論。
樣式驗證器新增規則
SwaggerHub 中的樣式驗證器工具可透過從一組可在多個 API 中強制執行的樣式規則中進行選擇，協助團隊標準化其 API 設計流程。我們在樣式驗證器中的規則清單中新增了三個新選項
- 操作必須只有一個標籤
- 操作必須至少有一個 2xx 回應
- 操作必須有預設回應
我們很高興將這些新功能和特性帶到 Swaggerhub，並期待看到團隊將如何創造性地運用新版本的規格。
立即試用這些新功能。 登入以開始使用。SwaggerHub 的新手嗎？ 今天免費開始使用。
感謝閱讀！正在尋找更多 API 資源嗎？訂閱 Swagger 電子報。每月接收一封包含我們最佳 API 文章、培訓、教學課程等的電子郵件。訂閱