API 管理是指設(shè)計、部署和維護(hù) API,同時確保 API 保持安全、可擴(kuò)展和可靠的過程。
API 治理是定義規(guī)定 API 管理方式的策略和程序的實(shí)踐。因此,API 治理包含 API 管理。
## API 治理的目標(biāo)是什么?
### 1. 從 API 混亂到一致性
API治理最顯著的方面是定義設(shè)計標(biāo)準(zhǔn),很多人認(rèn)為這只是為了確保API之間具有一定程度的一致性,其實(shí)更重要的是評估它們的實(shí)際影響,我們來看看在沒有有效標(biāo)準(zhǔn)時,設(shè)計師、開發(fā)者和提供商組織會遇到什么情況。
設(shè)計一個“搜索”的API操作可以有很多方法,如果沒有共享的標(biāo)準(zhǔn),兩個設(shè)計師可能會花時間尋找如何設(shè)計“搜索客戶”和“搜索產(chǎn)品”的操作方式,他們主要關(guān)注處理搜索過濾器、分頁或如何對搜索結(jié)果列表進(jìn)行建模。最后,在沒有雙方都能參考的標(biāo)準(zhǔn)下,這兩個API操作將不具備相同的外觀和行為特點(diǎn),從而導(dǎo)致不一致。
當(dāng)開發(fā)者使用“搜索客戶”功能時,他們會分析該操作以弄清楚其工作原理。他們識別出諸如過濾器和分頁處理方式或列表建模方式等設(shè)計模式,并據(jù)此編寫代碼。然后,在將調(diào)用“搜素產(chǎn)品”的功能集成到應(yīng)用程序中時,由于盡管這兩種操作都屬于 “搜素”,但它們并未共享相同外觀與行為特點(diǎn), 因此需要再次執(zhí)行以上步驟 。設(shè)計師之前學(xué)到的和編寫的代碼變得毫無用處,他們必須從頭開始。這可能導(dǎo)致一些開發(fā)者選擇不使用此類不一致的API,并尋找替代方案。
這種情況可能會出現(xiàn)在每個API的每個操作中。在提供商組織層面,交付并利用API將花費(fèi)更多資金,阻礙組織推出新功能。如果API是公開的,那意味著收入減少。
因此,__缺乏標(biāo)準(zhǔn)不僅導(dǎo)致了__ __API__ __間存在不一致性問題, 還對 API 設(shè)計師、消費(fèi)者以及提供商組織財務(wù)產(chǎn)生了負(fù)面影響。__
通過適當(dāng)?shù)腁PI治理實(shí)施設(shè)計標(biāo)準(zhǔn),其好處遠(yuǎn)不止于一致性,還包括:
– __預(yù)定義的設(shè)計方案使設(shè)計工作更輕松:__ 設(shè)計師可以專注于關(guān)鍵問題以及API需要解決的具體問題,而不是在常見功能上反復(fù)浪費(fèi)精力和時間。
– __一致的設(shè)計模式使用戶的工作更容易:__ 由于所有API調(diào)用都具有共同的外觀和行為,因此將任何API調(diào)用集成到應(yīng)用程序中變得簡單快捷。這也讓API更具吸引力。
– __有效的標(biāo)準(zhǔn)可以使提供商獲益更多:__ 交付更多功能所需時間較短,愿意使用API 的客戶數(shù)量增加,這都會帶來更高收入。
真正了解 API 治理就是要讓人們受益,并最大化 API 的價值。除了 [API 設(shè)計](http://www.dlbhg.com/wiki/api-design/)和標(biāo)準(zhǔn)之外,API 治理還可以涵蓋很多其他事物, 如 API 產(chǎn)品定義、安全性和實(shí)現(xiàn)等。它可以采取不同形式,如自動化、研討會或培訓(xùn)課程等。建立 API 治理時, 必須牢記所有這些內(nèi)容, 否則可能效果欠佳、完全無效或甚至適得其反。
## 如何提高API治理成功率?
### 1. 提高 API 意識
如果人們不知道 API 是什么或不了解它們的重要性、認(rèn)真對待它們的好處或忽視它們的可怕后果,那么試圖幫助人們有效地利用 API 是沒有用的。盡管 API 最初是一個 IT 主題,但 IT 團(tuán)隊并不總是完全理解它。必須讓他們認(rèn)識到,從純粹的 IT 角度來看,API 如何幫助他們、減慢他們的速度,甚至使他們的系統(tǒng)面臨風(fēng)險。但讓他們意識到 API(即使是私有 API)也會影響其組織的業(yè)務(wù)也很重要。說到業(yè)務(wù),與業(yè)務(wù)人員和高管討論 API 也很重要。讓他們明白,有效利用 API 意味著更快的上市時間或更多的收入應(yīng)該會產(chǎn)生良好的效果。
### 2. 揭開治理的神秘面紗并宣傳它如何提供具體幫助
除了提高認(rèn)識之外,與人們討論通過有效利用 API 可以獲得或失去什么,也是告訴他們您和 API 治理如何幫助他們的時機(jī)。現(xiàn)在是時候揭開他們的假設(shè)的神秘面紗,讓他們熟悉 API 治理——向他們展示如何具體地幫助他們。告訴他們您提供哪些內(nèi)部專業(yè)服務(wù):例如 API 審查、設(shè)計研討會或設(shè)計培訓(xùn)課程。告訴他們在哪里可以找到有關(guān)避免和解決常見問題的 [API 文檔](http://www.dlbhg.com/wiki/api-docs/),或者在哪里可以找到完整的 API 指南。
### 3.尋找分享者
最后但并非最不重要的一點(diǎn)是,由于 API 治理的聲譽(yù),治理可能只在某些地方受到歡迎。選擇你能贏得的戰(zhàn)斗;這些是首先要關(guān)注的地方。您會發(fā)現(xiàn)那里的人可能是精通 API 的開發(fā)人員、技術(shù)主管或架構(gòu)師,他們已經(jīng)在應(yīng)用或愿意應(yīng)用更好的實(shí)踐、分享他們的經(jīng)驗(yàn),甚至為治理做出貢獻(xiàn)。所有這些人都將有助于提高人們對 API 的認(rèn)識,并有助于展示有效利用 API 的價值。
## 參考資料:
*《[What is the purpose of API governance?](https://blog.postman.com/what-is-the-purpose-of-api-governance/)》,作者:[Arnaud Lauret](https://blog.postman.com/author/arnaud-lauret/)*