隨著各組織在 API 經濟中投入更多，他們也逐漸意識到確保 API 專案成功有多麼困難。隨著更多裝置被加入多平台生態系統，以及不同技能程度的消費者開始採用 API，因此絕對需要制定政策和管理，以確保專案取得成功。有許多平台，無論是基於雲端或內部部署，都允許組織抽象化其管理層。Google 的 Apigee 已成為 API 管理領域的領導者之一，擁有一套令人印象深刻的功能，以及龐大且忠誠的客戶群。隨著將 API 設計和文件流程整合到 Apigee 的需求日益增長，SwaggerHub 很自豪地推出與 Apigee Edge 的直接整合，這是用於管理 API 代理的平台。
與 Apigee Edge 的無縫整合
SwaggerHub 一直致力於提供最佳的協作式 API 設計和文件解決方案，使其能完美地融入您的軟體生命週期。API 設計和文件對 API 的開發和使用具有直接影響。因此，從初始設計階段開始，投資讓您的 API 獲得一流的待遇非常重要。但我們也了解客戶需要在一個專為控制和管理 API 使用，以及速率限制、監控和分析功能而建置的解決方案中管理其 API。與 Apigee 的直接整合進一步兌現了我們對確保 SwaggerHub 可以盡可能彈性地與許多軟體生命週期工具整合的承諾。這對客戶而言意味著，他們的 API 設計和文件可以輕鬆匯出到 Apigee Edge 作為代理，最終在不同的開發和生產環境中部署和管理它們。對於使用 OpenAPI (Swagger) 規格來設計和記錄 RESTful API 的團隊來說，SwaggerHub 是最強大的平台。透過這項最新的整合，SwaggerHub 現在可以作為您團隊 API 設計和文件的單一事實來源，並使其與 Apigee 強大的 API 管理解決方案保持同步。雖然概念很簡單，但它對組織的 API 開發生命週期具有強大的影響。此整合可以無縫彌合 API 開發和使用之間的差距，確保客戶在 SwaggerHub 上獲得兩全其美的好處。
運作方式
此整合功能使用非常簡單。您只需要具備以下條件即可開始使用
- SwaggerHub 團隊或企業帳戶
- Apigee Edge 帳戶
您可以在 SwaggerHub 上建立新的 API，或前往現有的 API。可以從 SwaggerHub 編輯器的右上角存取整合，您可以在其中從下拉式選單中選擇 Apigee Edge 整合。
然後，您可以新增您的 Apigee 授權，並設定幾個快速欄位來設定整合。這些欄位包括
- 名稱：此整合的顯示名稱，例如，Apigee。
- Apigee Edge 伺服器：用於存取 Edge 管理 API 的 URL。如果您使用 Apigee Edge Cloud（SaaS 版本），請保留預設值 https://api.enterprise.apigee.com/v1，否則，請將其替換為您的 Edge 執行個體的對應 URL。
- Apigee 電子郵件和 Apigee 帳戶密碼：您用來登入 Apigee Edge 的電子郵件和密碼。
- 組織：將在其中建立 API 代理的 Edge 帳戶中的組織。您可以在 Apigee Edge 的使用者名稱選單中看到您的組織名稱。
- API 名稱：已建立的 API 代理的唯一名稱。有效字元為字母、數字、破折號 (-) 和底線 (_)。您也可以指定現有 API 代理的名稱 - 在這種情況下，整合將建立此代理的新修訂版。代理名稱也將儲存在您 API 定義中的 x-apigee-id 金鑰中。
- 目標 URL – Apigee Edge 將請求路由到的端點。例如，http://api.example.com/reports/v2 或 https://myapi.com。如果您的 API 定義指定了 host、basePath 和 scheme，則為 scheme:host/basePath。
就是這樣！整合一旦啟用，就可以在每次儲存時觸發。SwaggerHub 將建立或更新指定的 API 代理，從現在開始，每次您儲存 API 定義時，都會建立代理的新修訂版。此代理充當現有後端 API 前的管理層，並允許您附加各種政策來管理流量、新增驗證、轉換有效負載等等。在此處閱讀有關 SwaggerHub Apigee Edge 整合的完整文件。
立即試用 Apigee 整合功能！
我們很高興將 Apigee 整合功能引入我們現有的各種外部軟體工具整合。如果您是現有的 SwaggerHub 使用者，您可以立即登入親自試用。如果您目前正在使用 Apigee 進行 API 管理，但尚未探索使用 SwaggerHub 進行 API 設計和文件，您可以免費試用 SwaggerHub 14 天。有任何意見/問題/回饋嗎？請在下方評論中告訴我們。