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

Gartner預測，到2024年，全球開(kāi)發(fā)人員數量將達到2870萬(wàn)人，比2020年增加320萬(wàn)人。其中大部分增加的人數會(huì )在中國，根據目前的趨勢，2023年中國的開(kāi)發(fā)人員增長(cháng)率將在6%到8%之間。

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

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

圖1：API設計四部曲

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

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

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

創(chuàng )建并遵守API標準

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

·       選擇正確的API類(lèi)型

·       遵循標準化原則

·       持續的API治理

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

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

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

·       降低或限制有效負載的大小

·       啟用緩存

·       使用異步請求/確認/投票

長(cháng)期培訓團隊成員，以持續地設計優(yōu)秀的API

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

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