## 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ù)面影響。__

### 2. 給人賦能，并價值最大化

通過適當(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://m.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)隊(duì)并不總是完全理解它。必須讓他們認(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://m.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/)*