摘 要：API管理是開放平臺最重要的功能，開放平臺對API的管理已經不能局限于請求的調用與轉發，而應該針對企業API的共性需求，提供一套完善的管理系統。
API開放平臺是企業互聯網化的產物，企業將自身業務能力以API方式開放出來，并通過開放API與開發者建立和維護關系。云開放平臺聚合各類API，并對API進行統一管理。
API管理是開放平臺最重要的功能，開放平臺對API的管理已經不能局限于請求的調用與轉發，而應該針對企業API的共性需求，提供一套完善的管理系統，這套管理系統應當包含以下要素。
1. 定制化接口調用
企業中不同部門、不同開發人員，由于自身技術或業務需求等原因，開發的API可能采用不同的協議、數據格式，而協議和數據格式的復雜性，必然會增加開發者使用API的成本。
API開放平臺應當集成API適配器，通過適配器對請求做統一的適配處理，并允許開發者自定義請求協議和數據格式，這樣可以讓開發者無需關心API底層的實現，按照自定義的方式來使用API。
2. 規范化地址映射
開放平臺的API管理中，所有的請求都經過開放平臺的網關進行轉發，因而地址映射是一個必須條件，這里還有兩項優勢：一是規范化請求地址，二是隱藏原始地址以保證安全。
規范化地址映射，目前有兩種可選方案，一種是根據配置的API服務名、版本號、資源名自動生成格式化的地址，這種方案格式化程度高，可以保證所有API統一規范，利于開發者的使用，但配置繁瑣，靈活度不夠高;另一種方案是由API發布者對每一個API的資源自定義映射地址，這種方案靈活度高，但規范化不強。
3. 應用虛擬化
應用虛擬化是指將現實中的應用轉移到平臺上，使用應用來訂閱并使用API，這是考慮到開發者的實際使用場景，并針對運維的需求所做的實現。當開發者有兩個應用A和B，A和B都需要使用接口C，可以使用A和B分別訂閱C，在應用A中使用接口C時，使用應用A訂閱所產生的認證信息，B也同樣如此。這樣做有兩個優勢：一是可以對A、B的調用分別做控制;二是可以統計到A、B分別對C的調用情況，以做進一步的數據分析。
4. 私有化API管理
API私有化是企業API管理中經常會遇到的場景：企業內部的API只對部分用戶開放(一般為企業內部開發人員或合作伙伴)。API私有化的解決方案有很多，目前最成熟的方案是依托于用戶域的API私有化管理。用戶域是指將有某些共性(比如屬于同一個公司)的用戶劃為一類，并對該類用戶提供特定的特殊權限。用戶域應用到API管理中，我們可以將某個公司的用戶劃到一個用戶域下，該公司私有化API發布的時候，選擇只發布到該用戶域下，這樣只有該用戶域的用戶才能看到并訂閱這些私有化的API。
5. 特殊資源管理
資源是API細維度的劃分，通常每個API會擁有多個可調用的資源。在某些場景中，基于安全的考慮，發布者并不希望所有的資源都開放給開發者，這就需要對一些資源做特殊的權限限制。比如某個公司的用戶信息管理API，里面有用戶普通信息、用戶隱私信息(包含身份證信息)等資源，其中，用戶普通信息可以開放給公司所有內部開發者，但用戶隱私信息，只能開放給限定的幾個開發者，這個時候就需要在資源層級對API的使用做調用限制。目前有一種可實現的方案：要使用調用控制的資源默認不開放，開發者可以向發布者申請權限，發布者審核通過后，開發者才可以使用該資源。
6. 生命周期管理
生命周期管理在API的管理中是尤為重要的功能，以滿足API發布和升級的需求。一個完整的聲明周期，應該包含：創建、測試、發布、過時、停用，平臺應當對不同生命周期的API進行不同的控制，比如對于創建和停用的API采取訪問限制，對測試API做詳細的測試分析，對過時的API使用進行過時提示。
7. 在線文檔和SDK管理
開放平臺使用在線文檔，有兩項優勢：一方面無需發布者使用其他方式來管理文檔，降低了發布者的API運營成本;另一方面，開發者無需其他操作即可查看API文檔，方便開發者使用API。
SDK管理針對非即用類的API，有很多API需要使用SDK來調用，這時候就要求平臺提供SDK的管理和下載功能。
以上是API開放平臺應具有的基礎API管理功能，與此同時，還應圍繞API管理提供各種周邊服務，如：統計分析、用戶域管理等。另外，開放平臺在管理API的過程中，要靈活地根據發布者和使用者雙方的需求，即時地對API管理系統做優化。
