中國卓越API設(shè)計的四個步驟

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

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

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

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

API用例識別和互動

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

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

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

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

·       選擇正確的API類型

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

·       持續(xù)的API治理

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

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

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

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

·       啟用緩存

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

長期培訓(xùn)團隊成員，以持續(xù)地設(shè)計優(yōu)秀的API

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

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