摘要：管理系統(tǒng)為任何市場提供一個完整的規(guī)范標準并使其能夠有效運行。在以下部分中，我們將探討在生態(tài)系統(tǒng)中發(fā)揮作用的技術和業(yè)務考慮因素，并討論創(chuàng)建和管理有效市場的關鍵步驟。專業(yè)和平臺開發(fā)人員為該平臺創(chuàng)建的服務將在電信公司的應用商店中發(fā)布。

各個行業(yè)的公司正在尋找通過外部API擴展服務來塑造數(shù)字業(yè)務的方法。然而，要獲得API的真正好處，是需要超越基本的API管理，再到創(chuàng)建API市場，這是一種專注于連接生產(chǎn)者和消費者的專用平臺業(yè)務模型。隨著越來越多的公司尋求商業(yè)平臺以獲得競爭優(yōu)勢，API市場將平臺業(yè)務模型的優(yōu)勢帶給了API管理。

API市場通常都會包括以下幾個部分：在典型的場景中，生產(chǎn)者首先發(fā)布API，然后通過API開發(fā)平臺對這些API進行編輯和測試運行。

API管理系統(tǒng)為任何API市場提供一個完整的規(guī)范標準并使其能夠有效運行。

第一個部分是使用有效的API開發(fā)平臺。在API市場中，API開發(fā)平臺必須提供直觀的體驗。

除了使用API開發(fā)平臺之外，企業(yè)還需要在市場中引入促進API重用的激勵措施，繼續(xù)推動API變現(xiàn)貨幣化。

在管理API市場時，企業(yè)需要保持對誰可以發(fā)布內(nèi)容和進度的控制，并確保根據(jù)既定的規(guī)范和標準（如URL模式，命名約定和訪問控制規(guī)則）發(fā)布合符要求的API。

因此，API市場通常不僅涉及開發(fā)平臺和API管理的其他技術方面，還涉及確保API實現(xiàn)其目標的業(yè)務和人員方面，尤其是促進API的消費和使用。在以下部分中，我們將探討在API生態(tài)系統(tǒng)中發(fā)揮作用的技術和業(yè)務考慮因素，并討論創(chuàng)建和管理有效API市場的關鍵步驟。

API市場通常都會包括以下幾個部分；在典型的場景中，生產(chǎn)者首先發(fā)布API，然后通過API開發(fā)平臺對這些API進行編輯和測試運行。使用者可以直接來到發(fā)布平臺，以查找，發(fā)現(xiàn)和探索API，也可以測試、調(diào)用監(jiān)控這些API。API市場的這部分是如何交互的情況如圖1所示。

圖1：API市場的關鍵組成

API管理系統(tǒng)為任何API市場提供一個完整的規(guī)范標準并使其能夠有效運行。它通常由五個核心組件組成：

API網(wǎng)關用作API運行時和策略執(zhí)行點，強制執(zhí)行限制，速率限制和安全策略。

API安全性可以由網(wǎng)關或通過集成的身份和訪問管理（IAM）基礎解決方案提供。

API開發(fā)平臺充當目錄，為應用程序開發(fā)人員提供編輯，監(jiān)控和測試API的集中位置。

PI開發(fā)平臺提供了從后端服務設計API的功能。

API分析提供API使用的快照和API貨幣化的Feed數(shù)據(jù)。

成功實施市場需要采用更先進的方法來實現(xiàn)API管理系統(tǒng)的某些方面，尤其是API開發(fā)平臺和分析。下面我們將研究構建強大API市場的五個基本要素，以促進使用API構建一個吸引更多人參與業(yè)務，增加收入流和提高忠誠度的應用程序。

第一個部分是使用有效的API獨立發(fā)布平臺。在API市場中，API開發(fā)平臺必須提供直觀的體驗，以支持企業(yè)開發(fā)人員方便編輯 – 無論是專業(yè)軟件開發(fā)人員，業(yè)務高級用戶還是長尾開發(fā)人員。API提供商可以選擇在平臺上受保護的注冊頁面后面托管所有資源和文檔，或者通過向公眾開放來提高透明度。使用者可以直接來到發(fā)布平臺，以查找，發(fā)現(xiàn)和探索API，也可以測試和調(diào)用特定的API。

一個很好的例子就是我們這個大型電信服務提供商的客戶，它構建了一個API驅動的應用程序/服務創(chuàng)建生態(tài)系統(tǒng)，它可以快速，輕松地創(chuàng)建運行在其上的數(shù)字，OTT（over-the-top）服務。依靠公司的移動通信平臺，為開發(fā)人員和非開發(fā)人員提供的獨立平臺，為用戶提供了直觀的體驗，可以在幾分鐘內(nèi)查看條款和條件，注冊并開始使用電信服務。

專業(yè)和平臺開發(fā)人員為該平臺創(chuàng)建的服務將在電信公司的應用商店中發(fā)布。量身定制的平臺開發(fā)策略使企業(yè)能夠提供來自各種開發(fā)商的應用程序，從初創(chuàng)企業(yè)到企業(yè)，政府機構，小型零售企業(yè)，學校，教堂和慈善機構內(nèi)的非開發(fā)人員。僅在前18個月，就有超過2,500名應用創(chuàng)建者根據(jù)電信業(yè)務的API發(fā)布了3,300多種應用和服務。

在典型的API管理環(huán)境中，組織的API所有者發(fā)布一組API，然后由應用程序開發(fā)人員使用。然而，為了使這個概念真正可持續(xù)，應用程序開發(fā)人員需要對發(fā)布的API的形式和類型有發(fā)言權。這可能包括將字段添加到API的請求，以及將許多不同的API混合到新的API以適應特定設備的約束和要求。實現(xiàn)這一目標的最簡單方法是建立跟蹤功能請求的論壇或票務系統(tǒng)，并促進API的消費者和生產(chǎn)者之間的通信。更具前瞻性的方法是API開發(fā)平臺本身允許消費者使用自助式沙盒平臺來混搭API并創(chuàng)建自己的私有API。后者為消費者提供了一個完美的平臺，可以創(chuàng)建自己的私有API，滿足應用程序的獨特需求，同時維護提供商發(fā)布的官方API。

除了創(chuàng)建門戶之外，企業(yè)還需要在市場中引入促進API重用的激勵措施，繼續(xù)推動API變現(xiàn)貨幣化。值得注意的是，在組織內(nèi)，激勵措施通常沒有貨幣價值，帶來的是其他的價值。例如，公司可能會維護一個排行榜，以突出頂級API發(fā)布者和應用程序開發(fā)人員，讓更多人愿意使用API。

企業(yè)還可以跟蹤哪些API擁有最多訂戶，并在開發(fā)平臺上的儀表板上顯示它們。允許開發(fā)人員學習和應用技能的研討會和黑客馬拉松也可以作為激勵措施。在尋求向外部各方提供激勵時，組織往往會采用某種形式的財務激勵措施。例如，前面討論的電信服務提供商允許用戶使用預定義的模板快速創(chuàng)建應用程序，然后使他們能夠共享從他們在公司的應用商店發(fā)布的應用程序生成的收入。

每項服務的收益分享模型對于服務的第三方創(chuàng)建者為70％，對于電信公司為30％。這使得該公司實現(xiàn)了使用其API構建的應用程序所帶來的收入環(huán)比增長20％。

API正迅速成為銷售或提供給應用程序開發(fā)人員的產(chǎn)品，從其他業(yè)務部門或使用它們的第三方組織獲得收入。因此，API市場需要直接或間接貨幣化API的機制。通過間接貨幣化，公司認識到更廣泛地使用API可以為其核心業(yè)務帶來更多客戶和交易，并擴展生態(tài)系統(tǒng)。一個很好的例子是StubHub，它是活動門票的主要賣家。其API計劃的目標是使旅游公司，酒店和其他酒店業(yè)的生態(tài)系統(tǒng)能夠向其客戶追加活動門票。只要酒店客戶使用酒店網(wǎng)站上的StubHub API，StubHub就能賺錢。

同時，組織可能希望采用兩種類型的直接貨幣化。通過直接內(nèi)部貨幣化，一個部門通常會回撥另一個部門以使用特定的API。由于資金是通過公司會計在內(nèi)部分配的，因此沒有實際的信用卡收費或電匯。在外部直接貨幣化方案中，企業(yè)銷售服務，客戶是外部業(yè)務，其解決方案由API提供。例如，Twilio銷售的API可讓Uber在Uber的移動應用程序中提供短信和電話。

在管理API市場時，企業(yè)需要保持對誰可以發(fā)布內(nèi)容和位置的控制，并確保根據(jù)組織標準（如URL模式，命名約定和訪問控制規(guī)則）發(fā)布正確的API。為此，他們需要確保包含有助于滿足戰(zhàn)略和合規(guī)要求的總體治理模型。

可以通過在集中式API開發(fā)平臺中發(fā)布API來集中管理API。但為了避免扼殺創(chuàng)造力，企業(yè)可能希望考慮采用自下而上的治理策略而不是自上而下的方法。例如，企業(yè)可以選擇分散的API發(fā)布模型，使每個業(yè)務部門在設計和發(fā)布API時具有自主權。

雖然主要目標是將結構應用于API的管理，但自下而上的方法通過使每個業(yè)務功能能夠獨立管理其各自的API（包括對這些已發(fā)布的API的更新或設計增強）來滿足此要求。通過簡化此任務，每個業(yè)務部門都可以在團隊成員構建和公開API的過程中發(fā)揮創(chuàng)造性，同時確保對其進行有效管理。

如何管理API以及如何利用API進行開發(fā)、測試、發(fā)布、監(jiān)控等一系列研發(fā)管理，一直是很多企業(yè)面臨的問題，國內(nèi)也有部分API管理平臺，但最推薦的是EOLINEKR，因為能讀取通過Github、Gitlab、碼云等代碼倉庫來讀取代碼的注解并自動生成API文檔，支持Java、PHP兩種語言，和完善的自動化測試管理，能夠完成利用API進行從研發(fā)測試到網(wǎng)關監(jiān)控，再到發(fā)布運行等一系列流程的研發(fā)管理解決方案。有興趣了解，官網(wǎng)：https://www.eolinker.com

如前所述，分析在支持API貨幣化方面發(fā)揮著重要作用。更廣泛地說，API分析使企業(yè)能夠深入了解性能，可用性和潛在安全問題的最新問題，以及隨著時間的推移分析以支持決策。企業(yè)通常最熟悉批量分析，可以將其用于識別隨時間發(fā)布的API的長期趨勢。其中一些趨勢包括錯誤的調(diào)用，延遲時間，跨地理位置的一般使用，隨時間的注冊，限制請求，異常響應警報和API健康可用性警報。

值得注意的是，通過機器學習進行的預測分析可以應用于實時和歷史（批量）數(shù)據(jù)的組合，以識別諸如潛在欺詐，用戶速率限制，即將發(fā)生的容量限制或其他因素等問題，以便及時做出應對。

最后，儀表板使業(yè)務和IT用戶能夠以有意義的方式可視化流式和批量分析的趨勢，以深入了解可用數(shù)據(jù)。通過儀表板，企業(yè)可以跟蹤一組常見趨勢，然后根據(jù)需要指定不同的警報。例如，企業(yè)可能希望跟蹤每個應用程序的API的一般用法，每個應用程序進行最多API調(diào)用的頂級用戶，以及每個應用程序API使用的資源路徑。

組織可能還希望使用儀表板來監(jiān)控每個應用程序的錯誤API調(diào)用的數(shù)量。例如，在錯誤調(diào)用中，消息通過故障序列進行調(diào)解，并且默認情況下，API管理系統(tǒng)會在后端服務不可用時將API調(diào)用視為錯誤。其他示例儀表板包括API延遲時間，跨地理位置的API使用，隨時間推移的開發(fā)人員注冊以及異常響應時間警報。

與任何企業(yè)一樣，成功取決于所有利益相關者的貢獻和參與，通過整合這里討論的技術和策略，企業(yè)將能夠很好地利用其當前的API管理計劃來創(chuàng)建API市場，從而推動擴張，創(chuàng)造新的商機并創(chuàng)造新的收入來源。

原標題：Key Steps to Building and Managing an Effective API Marketplace

作者：Mifan Careem，WSO2解決方案架構的高級主管

翻譯和修改：隔壁王書

原文地址：https://www.infoq.com/article...

配圖來源：www.softwaretestingmaterial.com 等