環(huán)球觀熱點(diǎn)：中國(guó)卓越API設(shè)計(jì)的四個(gè)步驟

文：Gartner研究總監(jiān)金瑋

Gartner預(yù)測(cè)，到2024年，全球開發(fā)人員數(shù)量將達(dá)到2870萬人，比2020年增加320萬人。其中大部分增加的人數(shù)會(huì)在中國(guó)，根據(jù)目前的趨勢(shì)，2023年中國(guó)的開發(fā)人員增長(zhǎng)率將在6%到8%之間。

應(yīng)用編程接口（API）可用于支持應(yīng)用程序之間的集成，提供現(xiàn)代化的多渠道用戶體驗(yàn)，以及創(chuàng)建客戶和合作伙伴生態(tài)系統(tǒng)。而如果沒有足夠的API標(biāo)準(zhǔn)和技能支撐，軟件開發(fā)團(tuán)隊(duì)會(huì)很難設(shè)計(jì)出能夠滿足開發(fā)人員期望的API。欠佳的API設(shè)計(jì)會(huì)導(dǎo)致繁瑣的開發(fā)人員體驗(yàn)，導(dǎo)致更少的消費(fèi)者會(huì)采用API。因此，改進(jìn)API設(shè)計(jì)應(yīng)該是中國(guó)IT領(lǐng)導(dǎo)者的首要任務(wù)。

(資料圖片)

為了設(shè)計(jì)出符合消費(fèi)者需求的高效、可靠API，IT領(lǐng)導(dǎo)者應(yīng)確保其團(tuán)隊(duì)了解API用例，運(yùn)用標(biāo)準(zhǔn)化的API設(shè)計(jì)實(shí)踐，以完成API最佳性能設(shè)計(jì)并對(duì)團(tuán)隊(duì)進(jìn)行培訓(xùn)（參見圖1）。

圖1：API設(shè)計(jì)四部曲

API用例識(shí)別和互動(dòng)

要設(shè)計(jì)出色的API，軟件開發(fā)團(tuán)隊(duì)必須清楚地了解它能為業(yè)務(wù)端和消費(fèi)者所提供的價(jià)值。不同的企業(yè)機(jī)構(gòu)和API消費(fèi)者有不同的需求和期望。為了滿足這些要求，軟件開發(fā)團(tuán)隊(duì)必須確定API使用者是誰以及他們將如何使用API。

明確用途。IT領(lǐng)導(dǎo)者必須確保其團(tuán)隊(duì)清晰了解API的用途——簡(jiǎn)而言之，就是API消費(fèi)者如何使用API的功能并與其服務(wù)交互。了解API的用途后，解決方案架構(gòu)師才能夠做出最適合API消費(fèi)者需求的設(shè)計(jì)決策，比如符合業(yè)務(wù)用例和預(yù)期的功能。

創(chuàng)建并遵守API標(biāo)準(zhǔn)

隨著時(shí)間的推移，IT團(tuán)隊(duì)將擴(kuò)充API組合，以滿足特定產(chǎn)品、服務(wù)和應(yīng)用程序的需求。如果沒有標(biāo)準(zhǔn)化和明確的API設(shè)計(jì)指南，API設(shè)計(jì)將多種多樣，缺乏一致性。因此，API使用者必須花時(shí)間去學(xué)習(xí)每種方法，而且更容易出錯(cuò)。為了降低這種復(fù)雜性并提高開發(fā)人員的生產(chǎn)力，軟件開發(fā)團(tuán)隊(duì)必須建立統(tǒng)一的API設(shè)計(jì)方法，以保持清晰的代碼的部署邏輯和功能實(shí)現(xiàn)。以下三個(gè)方式將幫助IT領(lǐng)導(dǎo)者實(shí)現(xiàn)此目標(biāo)。

選擇正確的API類型

遵循標(biāo)準(zhǔn)化原則

持續(xù)的API治理

通過限制有效負(fù)載大小、啟用可緩存性和使用異步請(qǐng)求模式來提高API性能

一個(gè)經(jīng)過深思熟慮的API設(shè)計(jì)，還需要考慮性能。API的性能，在很大程度上取決于它對(duì)不同請(qǐng)求類型和請(qǐng)求數(shù)量波動(dòng)的響應(yīng)程度。例如，中國(guó)的電商市場(chǎng)在過去幾年發(fā)展迅速，網(wǎng)購(gòu)交易規(guī)模迅速擴(kuò)大，網(wǎng)購(gòu)用戶數(shù)量同比增加了一倍。

自2020年新冠肺炎疫情席卷全球以來，線下消費(fèi)向線上消費(fèi)的大規(guī)模轉(zhuǎn)變進(jìn)一步刺激了中國(guó)電商行業(yè)的快速增長(zhǎng)。顯示用戶的當(dāng)前訂單是一個(gè)典型的電商用例場(chǎng)景。應(yīng)用程序可通過API獲取訂單的詳細(xì)信息，但如果用戶想在一個(gè)界面查看所有訂單，API要返回的數(shù)據(jù)就會(huì)比以前多，后端也將產(chǎn)生更高的負(fù)載。IT領(lǐng)導(dǎo)者必須確保其團(tuán)隊(duì)考慮使用哪些模式來提高性能，將其納入API指南。例如：

降低或限制有效負(fù)載的大小

啟用緩存

使用異步請(qǐng)求/確認(rèn)/投票

長(zhǎng)期培訓(xùn)團(tuán)隊(duì)成員，以持續(xù)地設(shè)計(jì)優(yōu)秀的API

在2022年Gartner3月熱門話題調(diào)查中，43%的IT領(lǐng)導(dǎo)者將缺乏技能列為API戰(zhàn)略面臨的最大挑戰(zhàn)之一。隨著API技術(shù)的不斷發(fā)展，它能夠提供比以往更豐富、更復(fù)雜的功能。

所有IT團(tuán)隊(duì)成員都應(yīng)積極參與有關(guān)API和開發(fā)的長(zhǎng)期培訓(xùn)。只有當(dāng)API使用者與設(shè)計(jì)者預(yù)期的場(chǎng)景一致時(shí)，API才會(huì)以最佳方式執(zhí)行。在API設(shè)計(jì)、開發(fā)和使用的整個(gè)生命周期中，IT領(lǐng)導(dǎo)者必須安排持續(xù)的輔導(dǎo)教育，提高團(tuán)隊(duì)對(duì)API技術(shù)的掌握程度，確保API始終符合并有效滿足業(yè)務(wù)需求。

關(guān)于Gartner

Gartner（紐約證券交易所代碼：IT）為高管及其團(tuán)隊(duì)提供可執(zhí)行的客觀性洞察。我們的專業(yè)指導(dǎo)和各類工具可以幫助企業(yè)機(jī)構(gòu)在關(guān)鍵優(yōu)先事項(xiàng)上實(shí)現(xiàn)更快、更明智的決策以及更出色的業(yè)績(jī)。欲了解更多信息，請(qǐng)?jiān)L問http://www.gartner.com/cn。

關(guān)鍵詞： 開發(fā)人員 軟件開發(fā) 應(yīng)用程序 有效負(fù)載 生命周期