中國卓越API設計的四個步驟

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

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

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

圖1：API設計四部曲

API用例識別和互動

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

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

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

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

·       選擇正確的API類型

·       遵循標準化原則

·       持續(xù)的API治理

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

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

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

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

·       啟用緩存

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

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

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

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