SwaggerHub 的最新功能是整合功能,這是一種透過連線到您現有的工具組來推動 API 生命週期的新方式。整合是可以在您的 API 定義中新增的軟體片段,以擴展 SwaggerHub 在您控制下的功能。它們可以在您的 API 規格右側找到,如下圖所示

SwaggerHub 最初公開兩個使用者整合 - GitHub 同步和 Webhooks。
GitHub 同步
GitHub 同步允許產生的程式碼與您的 GitHub 儲存庫自動同步。這表示不再需要下載、合併程式碼、複雜的設定或腳本。只需指定要產生的目標、GitHub 儲存庫資訊以及檔案/資料夾資訊,您的用戶端和伺服器就會始終與您的 Swagger 定義保持最新狀態。用戶端、伺服器都可以推送到一個或多個儲存庫。Swagger 有 28 個不同的用戶端和 13 個伺服器目標,由 Swagger 社群的專家慷慨貢獻。這表示您無需大量工程師手工製作即可開始提供用戶端 SDK。由於您控制同步流程,您仍然可以在 SDK 中新增額外的邏輯,而無需擔心您的變更會被產生器覆蓋。

請查看下面的簡短螢幕錄影,了解 GitHub 同步如何運作。您可以隨時閱讀功能文件,以了解有關整合的更多資訊。
Webhooks
Webhooks 允許您在您感興趣的生命週期事件期間觸發您自己的服務和整合。觸發時,Swagger 定義會針對多個事件推送至您定義的服務。無論是觸發建置、單元測試、向開發人員傳送電子郵件或其他操作,您都可以透過 SwaggerHub Webhooks 設想自動化場景。

在上面的範例影像中,每次儲存 API 版本時,都會將 HTTP POST 承載傳送到 Jenkins。使用者可以新增多個生命週期事件,並透過 HTTP POST 表單資料或 JSON 主體以 JSON 格式返回承載。請閱讀功能文件以了解更多資訊。請密切注意在不久的將來會出現更多 SwaggerHub 整合,以協助您快速有效地開發 API!