如何開始使用 OpenAPI 3.0

  2018 年 5 月 23 日

OpenAPI 規格 (OAS) 是驅動和加速 API 開發的最佳開放標準。隨著 API 經濟每年不斷擴大,重要的是您要以人類和電腦都能輕易理解的格式定義您的 API,為 API 的成功做好準備。

OAS 指定描述 API 介面所需的規則和語法。它不斷演進以滿足現代 API 團隊的需求,並持續推出更新,以簡化規格的使用和理解。

最新版本的 OpenAPI,OAS 3.0,於去年發布,並已獲得開發人員的廣泛採用,並受到社群的歡迎。OAS 3.0 結構更簡單,可以使用連結更好地表達關係,多部分文件處理更輕鬆,內容否定和更多功能現在可供 API 愛好者在 OAS 3.0 中使用。

雖然每個人都想利用最新版本,但當您想為現有的 API 執行時,可能會變得棘手。

無論您是要將 Swagger 2.0 中定義的 API 遷移到 OAS 3.0,還是有許多甚至沒有定義的舊版 API,現在轉換到 OpenAPI 都為時不晚。有很多選項可以幫助您完成此流程,但是,它們很笨重且需要一些學習曲線。Swagger 提供了一些工具來幫助您快速輕鬆地上軌道,以便您可以專注於更重要的開發任務。

在我們的網路研討會「遷移到 OpenAPI 3.0:如何使用 Swagger 工具轉換現有 API」中,我們將介紹 OAS 3.0 的新功能,以及當您已經有現有的 API 實作或較舊的 Swagger 定義時,如何輕鬆建立您的 OAS 3.0 定義。

以下是您將學到的內容 -

  1. OAS 3.0 的新功能
  2. 如何使用 SwaggerHub 開源 Maven 外掛程式透過程式碼註解產生 OAS 3.0 定義
  3. 如何使用 Swagger Inspector 從 API 端點產生 OAS 3.0 定義
  4. 如何使用 SwaggerHub 將 Swagger 2.0 定義轉換為 OAS 3.0 定義
  5. 如何使用 OAS 3.0 和 SwaggerHub 建立對使用者友好的 API

立即觀看