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

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

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

API管理系統(tǒng)為任何API市場(chǎng)提供一個(gè)完整的規(guī)范標(biāo)準(zhǔn)并使其能夠有效運(yùn)行。

第一個(gè)部分是使用有效的API開發(fā)平臺(tái)。在API市場(chǎng)中，API開發(fā)平臺(tái)必須提供直觀的體驗(yàn)。

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

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

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

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

圖1：API市場(chǎng)的關(guān)鍵組成

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

API網(wǎng)關(guān)用作API運(yùn)行時(shí)和策略執(zhí)行點(diǎn)，強(qiáng)制執(zhí)行限制，速率限制和安全策略。

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

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

PI開發(fā)平臺(tái)提供了從后端服務(wù)設(shè)計(jì)API的功能。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

原標(biāo)題：Key Steps to Building and Managing an Effective API Marketplace

作者：Mifan Careem，WSO2解決方案架構(gòu)的高級(jí)主管

翻譯和修改：隔壁王書

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

配圖來源：www.softwaretestingmaterial.com 等