作者：Janet Wagner
將 API 與應用程式和系統整合的公司數量正與日俱增。根據 Cloud Elements 2018 年 API 整合狀態報告，61% 的 API 產業專業人士認為 API 整合對其業務策略至關重要，而 57% 的人表示他們將自己的組織視為平台供應商。
對於積極部署 API 驅動業務策略的公司而言，治理是必要的。
治理對於擁有 API 設計計畫或微服務架構的組織尤其有益。本文重點說明 API 治理為何重要，並涵蓋一些 API 治理的最佳實踐。
API 治理的主要目標：一致性
將自己視為平台供應商的公司數量正在增加，建立 API 和應用程式的公司數量也在增加。而且，組織規模越大，公司可能會建置和使用的 API 數量就越多。組織建置的應用程式通常會使用內部和第三方 API。
正如我們在關於 採用 API 優先方法建置產品的文章中所解釋的，一致性是關鍵。治理流程可以協助確保 API 在整個組織中保持一致。治理還有助於防止重複程式碼、元件之間緊密耦合、不可靠和服務過多等問題。
您知道您的 API 在哪裡嗎？
API 佈道者 Kin Lane 最近發表了一篇文章，內容關於 API 治理，他表示他經常遇到「甚至不知道他們所有 API 在哪裡」的公司。Lane 建議，在您實施和維護 API 治理之前，您需要做一些事情。其中包括知道您的 API 在哪裡、清點您現有的 API 並建立組織結構圖。
在您規劃 API 的發展方向之前，您需要先了解您目前 API 的狀況。
API 治理應包含哪些內容？
在您清點完您的 API 後，API 治理應包含哪些內容？
1. 集中化
建立和強制執行政策的中心點。通常會建立一個團隊來處理整個組織的 API 治理。
2. API 合約
有些公司正在採用 API 優先方法進行應用程式開發，我們在另一篇部落格文章中討論了這個方法。建立合約有助於確保 API 保持一致且可重複使用。它還允許開發團隊平行工作 - 團隊可以建立模擬、測試和部署 API。
3. 樣式指南
標準化 API 設計可確保組織建置的所有 API 保持一致。標準化 API 設計的一種方法是為所有 API 建立並強制執行樣式指南。SwaggerHub 具有內建樣式驗證，因此組織可以維持所有 API 的樣式一致性。
4. 可重複使用性
標準化 API 設計不僅確保 API 在整個組織中保持一致，而且還包含可重複使用的元件。此外，SwaggerHub 網域可以協助提高設計資源的可重複使用性。
5. 自動化
API 合約、文件和追蹤是可以自動化的流程，應該是整體 API 治理的一部分。如今，有許多工具可以自動化 API 設計和治理流程。例如，SwaggerHub 提供用於標準化設計樣式和管理通用模型的工具。
6. 版本控制
版本控制可協助開發人員追蹤和維護不同版本的 API。您可以使用版本控制來淘汰舊版本的 API，並以新版本取代它。內容協商是追蹤不同版本 API 的另一種方式。版本控制或內容協商可能會根據您的特定情況而運作。
7. 淘汰政策
版本控制可有效地協助更容易地淘汰 API。一個有效的淘汰政策對您的 API 消費者有利，因為它提供穩定性。開發人員將知道在淘汰 API 時會發生什麼，您可以控制 API 何時以及如何最終停止使用。
8. 追蹤
追蹤 API 的許多方面應該是您 API 治理的一部分。追蹤 API 的部署位置、誰在使用 API、如何使用 API、路由資訊以及 API 生命週期的其他元素。
9. API 探索
隨著 API 和治理工具的數量增加，必須提供一種方法，以便輕鬆搜尋和探索已部署的 API 和目前使用的工具。為了分析應用程式使用 API 的未來影響，也必須提供一種描繪相依性的方法。例如，Capital One 實施了服務探索入口網站，並啟用自動發佈到該入口網站。
那麼，為何要實施 API 治理？
API 治理有助於節省時間和金錢，因為它可以實現 API 的一致性、允許重複使用元件，並確保主動建置 API 以達成特定目標並為企業帶來價值。API 治理還有助於公司針對 API 計畫做出明智的決策，並建立建置、部署和使用 API 的最佳實踐。
當組織中的每個人在 API 方面都保持一致時，您的 API 計畫將會變得更加有效率、有價值和成功。
想要實施 API 治理政策嗎？了解 SwaggerHub 如何提供協助。
感謝您的閱讀！正在尋找更多 API 資源嗎？訂閱 Swagger 電子報。每月收到一封電子郵件，其中包含我們最佳的 API 文章、培訓、教學課程等等。訂閱