2017 年標誌著最新版本的 OpenAPI 規格 OpenAPI 3.0 正式發布。
這是自 2015 年該規格捐贈給 OpenAPI 計畫以來首次重大發布。此發布標誌著 API 描述格式的演變以及它們在協助團隊開發出色 API 方面的作用的重要里程碑。
自 OpenAPI 3.0 發布以來，Swagger 團隊一直致力於推出新資源，以協助團隊開始使用最新版本的 OpenAPI。我們在兩個主要的開源 Swagger 專案 — Swagger-UI 和 Swagger-Editor 中發布了對 OAS 3.0 的初始支援，並發布了在 SwaggerHub 中設計、記錄和轉換 API 為 OpenAPI 3.0 的支援。
在 2018 年，我們預計會在整個 API 領域看到更多工具添加對 OAS 3.0 的支援。自正式發布以來，我們有機會參加了 APIStrat 2017 和 AWS re:Invent 等行業活動，在那裡我們聽取了數百位 API 從業人員的意見，他們希望在設計和記錄 API 之外，也能使用 OAS 3.0 來測試和部署到 API 閘道。
為了協助您的團隊轉換到 OpenAPI 3.0，我們想分享一些我們整理的培訓和文件，以協助團隊採用 OpenAPI 3.0。
了解 OpenAPI 3.0 的新功能，並查看最新版本對於支援它的 Swagger 工具意味著什麼。
了解更多
SwaggerHub 是首批提供 OpenAPI 3.0 支援的 API 設計和文件平台之一。您也可以將現有的 2.0 規格轉換為最新版本的 OpenAPI。了解如何在 SwaggerHub 中開始使用 OpenAPI 3.0。
了解更多關於 SwaggerHub 中 OAS 3.0 支援的資訊。
您可以在 Swagger.io 上找到 OpenAPI 3.0 和 Swagger 2.0 規格的文件。更新的文件包括詳細介紹 3.0 規格中更新的結構和新功能。
學習新的規格。
在本次培訓中，我們將介紹 OpenAPI 3.0 的最新改進。Swagger 開發人員傳道師和 OAI TSC 成員 Ron Ratovsky 涵蓋了主要更新，例如：改善的可重複使用性、參數變更、內容協商支援、描述回呼的支援、連結、改進的範例和增強的安全性定義。
了解更多關於 OAS 3.0 最新功能的資訊。
本次培訓提供了在 SwaggerHub 中使用 OpenAPI 3.0 定義新 API 的現場示範。查看 OpenAPI 的新結構的實際應用，並查看如何使用 SwaggerHub 編輯器透過 OpenAPI 3.0 定義和視覺化您的 API 文件。
了解更多關於使用 OAS 3.0 設計和記錄 API 的資訊。
OpenAPI 是規格的正式名稱。規格的開發由 OpenAPI 計畫促進，該計畫涉及來自科技界不同領域的 30 多個組織，包括 Microsoft、Google、IBM 和 CapitalOne。領導 Swagger 工具開發的公司 Smartbear Software 也是 OpenAPI 計畫的成員，協助領導規格的演變。
了解更多關於 OpenAPI 和 Swagger 之間的區別。
SmartBear 的 Swagger/SwaggerHub 產品行銷經理 Keshav Vasudevan 在 APIStrat 2017 上與 OAI 技術指導委員會 (TSC) 的 Darrel Miller 坐下來討論 OpenAPI 的最新資訊以及專案的目前狀態。
閱讀完整對話。
其他資源
自 OpenAPI 3.0 發布以來，API 領域已發布了許多寶貴的資源，以協助團隊學習和採用新的 OpenAPI 3.0 規格。以下是我們從其他 API 組織和從業人員中挑選的一些最愛
準備好開始使用 OpenAPI 3.0 了嗎？了解更多關於 SwaggerHub 中 OAS 3.0 支援的資訊。