剛成為產(chǎn)品經(jīng)理的時(shí)候常常聽到開發(fā)吐槽：“這產(chǎn)品經(jīng)理啥都不懂软吐，這個(gè)需求那么多接口皮假，開發(fā)都?jí)騿苓€要聯(lián)調(diào)，居然就排這么點(diǎn)開發(fā)時(shí)間盘寡，出了什么問題我可不負(fù)責(zé)！”每次聽到這樣的吐槽總會(huì)一臉懵逼撮慨，什么接口竿痰？什么聯(lián)調(diào)？我又做錯(cuò)了什么砌溺？

后來自己做過開發(fā)之后菇曲，開始了解到，在系統(tǒng)層面上抚吠，除了看得到的頁面功能常潮，還有很多隱藏在頁面功能之下的接口，這篇文章就簡(jiǎn)單總結(jié)一下我眼中的接口是什么樣的楷力、以及為何要學(xué)習(xí)API接口知識(shí)喊式。

什么是接口孵户？

API接口：應(yīng)用程序接口（API：Application Program Interface），是一組定義岔留、程序及協(xié)議的集合夏哭，通過 API 接口實(shí)現(xiàn)計(jì)算機(jī)軟件之間的相互通信。

打個(gè)比方献联，如果我開了一家銀行竖配，開放了存/取款的服務(wù)。普通儲(chǔ)戶通過手上的支票想取走存款里逆，必須先找到對(duì)應(yīng)的【位置】进胯，也就是正確的銀行、正確的柜臺(tái)原押。按照銀行規(guī)定的【支票格式】填寫好胁镐，那么就可以憑這個(gè)“支票”里拿走錢。另外诸衔，柜臺(tái)是有限的盯漂、來取錢的客戶可能會(huì)很多，因此也就需要客戶【取號(hào)排隊(duì)】笨农，一個(gè)接著一個(gè)有序的進(jìn)行取款服務(wù)就缆。另外，為了安全和服務(wù)質(zhì)量的考慮谒亦，銀行柜臺(tái)需要有【反饋機(jī)制】违崇，如果客戶支票填寫有誤、或者支票過期了诊霹，需要告訴客戶回去重新填寫羞延。

【位置】就是系統(tǒng)對(duì)外發(fā)布的API地址，包含了IP脾还、端口伴箩、API名稱等信息；

【支票格式】是這個(gè)接口的數(shù)據(jù)傳輸規(guī)范鄙漏，比如：SKU只支持9位長(zhǎng)度的字符串?dāng)?shù)據(jù)嗤谚，庫存只支持16位長(zhǎng)度的數(shù)字，如果傳參格式不對(duì)怔蚌，那么就會(huì)啟動(dòng)【反饋機(jī)制】巩步；

【取號(hào)排隊(duì)】就是接口的“消息隊(duì)列”，消息隊(duì)列的主要特點(diǎn)是異步處理桦踊，可以減少請(qǐng)求響應(yīng)的時(shí)間和解耦椅野。想象一下，如果取錢的人不【取號(hào)排隊(duì)】而是一哄而上涌上柜臺(tái)，柜臺(tái)還能提供正常的服務(wù)嗎竟闪？

【反饋機(jī)制】就是接口中的返回參數(shù)离福，為了保證對(duì)方能夠正常獲取所有的數(shù)據(jù)，不至于因?yàn)閿?shù)據(jù)異常之類的原因?qū)е聰?shù)據(jù)丟失炼蛤，在發(fā)現(xiàn)異常的時(shí)候妖爷，需要告知對(duì)方發(fā)生了什么異常，為什么無法獲取到這個(gè)數(shù)據(jù)理朋，對(duì)方就會(huì)根據(jù)這個(gè)反饋?zhàn)龀鱿鄳?yīng)的調(diào)整絮识，或者重新發(fā)起請(qǐng)求、或者放棄這種數(shù)據(jù)嗽上。

注：開發(fā)人員口中的“聯(lián)調(diào)”次舌，簡(jiǎn)而言之就是兩個(gè)系統(tǒng)的開發(fā)人員之間對(duì)這個(gè)接口調(diào)用成功與否、數(shù)據(jù)能否正常獲取等場(chǎng)景進(jìn)行測(cè)試炸裆，由于接口聯(lián)調(diào)涉及到跨系統(tǒng)的開發(fā)人員之間配合垃它，所以一般需要在正常的開發(fā)時(shí)間之外預(yù)留出一段時(shí)間給到開發(fā)人員進(jìn)行聯(lián)調(diào)鲜屏。

接口的類型有多少種烹看？

上面只是用一個(gè)比較通俗的例子對(duì)接口的原理進(jìn)行說明，實(shí)際上接口的類型有很多洛史，下面會(huì)根據(jù)不同的接口類型講講各種類型接口之間的區(qū)別：

一惯殊、根據(jù)響應(yīng)的機(jī)制可以分為同步、異步接口：

同步接口：A系統(tǒng)請(qǐng)求B系統(tǒng)接口之后也殖，必須獲得B系統(tǒng)接口的響應(yīng)后才會(huì)執(zhí)行下一步操作土思；

例如：登錄操作的時(shí)候調(diào)用第三方平臺(tái)接口（如微信）進(jìn)行登錄，需要跳轉(zhuǎn)到微信進(jìn)行驗(yàn)證并返回驗(yàn)證結(jié)果后忆嗜，才能登錄成功己儒；

異步接口：A系統(tǒng)請(qǐng)求B系統(tǒng)接口之后，不需要等待源系統(tǒng)返回結(jié)果就可以進(jìn)行下一步操作捆毫；

例如：在滴滴打車之后闪湾，司機(jī)點(diǎn)擊結(jié)束行程后，不需要等待銀行付款成功之后再開始下一個(gè)訂單绩卤。因?yàn)榇藭r(shí)滴滴已經(jīng)驗(yàn)證過司機(jī)途样、乘客的銀行賬戶或者支付寶賬戶，確認(rèn)了雙方交易的合法性就可以結(jié)束訂單濒憋。這時(shí)我們看到的是我們已經(jīng)付款成功（其實(shí)銀行可能還沒扣款）何暇，而滴滴后臺(tái)會(huì)將這筆交易流水傳給銀行，在銀行驗(yàn)證后再進(jìn)行扣款凛驮、付款操作裆站。

二、根據(jù)接口的觸發(fā)形式可以分為分發(fā)、訂閱接口：

分發(fā)接口：A系統(tǒng)產(chǎn)生新數(shù)據(jù)的時(shí)候就分發(fā)給B系統(tǒng)（也可以是多個(gè)）遏插；

例如：電商網(wǎng)站后臺(tái)的客戶管理系統(tǒng)捂贿，在產(chǎn)生了一個(gè)新的黑名單客戶的時(shí)候，就會(huì)將數(shù)據(jù)分發(fā)到訂單胳嘲、推薦等等各個(gè)系統(tǒng)厂僧，以便及時(shí)攔截這部分客戶的訂單；

訂閱接口：B系統(tǒng)在需要的時(shí)候調(diào)用A系統(tǒng)的接口進(jìn)行數(shù)據(jù)訂閱了牛；

例如：用戶在股票交易軟件中查詢銀行賬戶余額的時(shí)候才會(huì)調(diào)用銀行的余額查詢接口颜屠，而股票交易軟件自身不存儲(chǔ)這個(gè)數(shù)據(jù)；

產(chǎn)品經(jīng)理了解接口有什么用鹰祸？

以上不同類型的接口分別有不同的使用場(chǎng)景甫窟，個(gè)人認(rèn)為產(chǎn)品經(jīng)理不需要理解各種接口的實(shí)現(xiàn)原理，但是要了解什么場(chǎng)景應(yīng)該使用什么樣的接口蛙婴，以便更好地對(duì)外提供數(shù)據(jù)服務(wù)粗井。個(gè)人看來，了解接口有以下幾個(gè)好處：

①明確各個(gè)系統(tǒng)之間的數(shù)據(jù)流轉(zhuǎn)街图，特別是功能系統(tǒng)的產(chǎn)品經(jīng)理浇衬，只有在知道了功能設(shè)計(jì)的目的、需要對(duì)外提供什么樣的接口服務(wù)餐济，需求設(shè)計(jì)階段才能夠考慮得更加全面耘擂；

②掌握開發(fā)總體工作量，而不局限于功能絮姆；另外醉冤，在安排項(xiàng)目計(jì)劃時(shí)能夠考慮到與周邊系統(tǒng)聯(lián)調(diào)的時(shí)間，計(jì)劃安排才會(huì)更加合理篙悯；

③識(shí)別項(xiàng)目中的關(guān)鍵風(fēng)險(xiǎn)點(diǎn)蚁阳，特別是一些關(guān)鍵接口、數(shù)據(jù)量大需要進(jìn)行大數(shù)據(jù)壓測(cè)的接口，需要盡早安排聯(lián)調(diào)和測(cè)試，并且對(duì)周邊配合的項(xiàng)目提出要求入挣；

產(chǎn)品經(jīng)理如何寫接口文檔？

在度娘就可以找到不少現(xiàn)成的接口文檔归粉，可以參考騰訊開放平臺(tái)上的API列表http://wiki.open.qq.com/wiki/API%E5%88%97%E8%A1%A8，這里簡(jiǎn)單總結(jié)幾個(gè)要點(diǎn)：

1漏峰、聲明接口字段和返回參數(shù)糠悼，字段需要聲明是否必填、字段類型浅乔、長(zhǎng)度以及處理規(guī)則倔喂；

2铝条、聲明接口預(yù)估的數(shù)據(jù)量大小、調(diào)用頻率等席噩，以保證開發(fā)時(shí)考慮到接口的健壯性班缰；

3、聲明接口的異常處理方式悼枢，如失敗的數(shù)據(jù)是否重發(fā)埠忘、重發(fā)次數(shù)等等；

注：在之前的產(chǎn)品設(shè)計(jì)過程中馒索，還出現(xiàn)過配合系統(tǒng)雙方的產(chǎn)品經(jīng)理為了誰應(yīng)該來寫接口文檔而爭(zhēng)執(zhí)過莹妒，后來定了一套標(biāo)準(zhǔn)，個(gè)人認(rèn)為是比較合理的绰上，供大家參考：

原則1：一般是由數(shù)據(jù)的需求方來編寫接口需求文檔旨怠；

原則2：如果該接口是一個(gè)分發(fā)接口，則由數(shù)據(jù)的提供方來編寫接口需求文檔蜈块；

總結(jié)：

好了鉴腻，說到這里，已經(jīng)把我個(gè)人這些年工作中所接觸到的API接口簡(jiǎn)單介紹了一下百揭，由于本人一直是做后端產(chǎn)品經(jīng)理爽哎，因此對(duì)于前端的接口涉獵不多，不了解差異有多大信峻，以上內(nèi)容僅供后端產(chǎn)品經(jīng)理參考倦青，也希望大家能夠?qū)ξ闹械囊恍╁e(cuò)誤及時(shí)指正瓮床。

另外盹舞，作為一名大數(shù)據(jù)的產(chǎn)品經(jīng)理，大數(shù)據(jù)如何利用接口對(duì)外提供服務(wù)隘庄？后續(xù)總結(jié)出自己的一套方法論后再跟分享踢步。