API接口對(duì)于B端產(chǎn)品經(jīng)理來(lái)說(shuō)是個(gè)再熟悉不過(guò)的詞匯了。雖然它是技術(shù)范疇的東西，但作為B端產(chǎn)品經(jīng)理如果不懂得它的使用場(chǎng)景和解讀方法，在實(shí)際工作中是很難順利完成產(chǎn)品方案的。因此本文將重點(diǎn)探討API的使用場(chǎng)景，及在不同場(chǎng)景下產(chǎn)品經(jīng)理如何解讀API接口去順利完成產(chǎn)品工作。

一、API接口是什么

“接口”這一詞應(yīng)該是B端產(chǎn)品經(jīng)理日常和開(kāi)發(fā)溝通最多的詞匯之一了，經(jīng)常聽(tīng)到接口文檔、接口聯(lián)調(diào)等等。API接口的定義是一種規(guī)范或約定，用于描述軟件系統(tǒng)中不同組件之間的通信協(xié)議和數(shù)據(jù)交互方式。API接口定義了一組可用的操作、消息格式、數(shù)據(jù)結(jié)構(gòu)和參數(shù)，以及雙方之間如何進(jìn)行通信和交互。通過(guò)API接口，軟件系統(tǒng)的不同部分可以相互調(diào)用和協(xié)作，實(shí)現(xiàn)數(shù)據(jù)的傳遞、功能的調(diào)用和共享資源的訪問(wèn)，同時(shí)保持系統(tǒng)的安全性和穩(wěn)定性。（一堆官方廢話，先不用管往下看）

接口在形式上由四部分構(gòu)成：方法（get，post等）、url（請(qǐng)求地址）、請(qǐng)求參數(shù)、返回參數(shù)

在功能實(shí)現(xiàn)上由三個(gè)主要部分構(gòu)成：輸入，邏輯處理，輸出。（產(chǎn)品需要關(guān)注的）

二、API的主要作用

2.1 前后端數(shù)據(jù)傳遞和功能調(diào)用的橋梁

接口聯(lián)調(diào)是前后端開(kāi)發(fā)工作中很重要的一部分，現(xiàn)在都采用前端后端分離的開(kāi)發(fā)模式。通常來(lái)說(shuō)在接收到產(chǎn)品需求后，后端會(huì)先定義好接口文檔給到前端，前端在完成界面展示的代碼編寫(xiě)，后端完成了接口的邏輯處理就需要開(kāi)始進(jìn)行聯(lián)調(diào)，以確保接口能夠從輸入到輸出的正常運(yùn)作。

以新增客戶為例：新增客戶接口的功能就是把用戶輸入的客戶信息寫(xiě)入到數(shù)據(jù)庫(kù)中。接口輸入：客戶信息。邏輯處理：是否可以新增成功？（這里面涉及的規(guī)則就需要產(chǎn)品經(jīng)理來(lái)確定）輸出：返回前端處理結(jié)果。

產(chǎn)品涉及工作：接口在前后端的應(yīng)用一般不需要產(chǎn)品經(jīng)理特別關(guān)注接口本身，產(chǎn)品經(jīng)理需要重點(diǎn)關(guān)注的是規(guī)則的制定。也是后端經(jīng)常跟我說(shuō)的實(shí)現(xiàn)肯定是可以實(shí)現(xiàn)，但你要定個(gè)規(guī)則給我。

2.2 系統(tǒng)對(duì)接

在B端工作中經(jīng)常會(huì)涉及到跨系統(tǒng)的需求對(duì)接，比如我從事的供應(yīng)鏈金融領(lǐng)域會(huì)經(jīng)常涉及到與資方進(jìn)行系統(tǒng)對(duì)接共同實(shí)現(xiàn)客戶的借貸全生命周期的系統(tǒng)流程。那么跨系統(tǒng)交互的重要工具正是API接口。下圖為我司查詢客戶授信結(jié)果流程圖和接口（輸入：客戶編號(hào) 邏輯判斷：客戶是否滿足授信通過(guò)規(guī)則 輸出：客戶授信狀態(tài)、授信時(shí)間等）。

產(chǎn)品涉及工作：在系統(tǒng)對(duì)接需求中，可能就會(huì)涉及到產(chǎn)品經(jīng)理對(duì)于接口的應(yīng)用。重點(diǎn)需要關(guān)注接口中的請(qǐng)求參數(shù)和響應(yīng)參數(shù)。

例1：資方需要我們?cè)诳蛻羰谛帕鞒讨刑峁┛蛻粜畔ⅲ敲促Y方會(huì)出具一份客戶授信信息接口，產(chǎn)品經(jīng)理就需要明確這份接口中資方想要的是哪些字段信息，我們?cè)谙到y(tǒng)什么節(jié)點(diǎn)調(diào)用此接口，這些信息如何獲取等等。

例2：上述例子是需要產(chǎn)品向外部系統(tǒng)提供數(shù)據(jù)，那么反過(guò)來(lái)也會(huì)涉及到向外部系統(tǒng)要數(shù)據(jù)。那么往往有時(shí)候我們會(huì)發(fā)現(xiàn)外部提供的接口字段數(shù)據(jù)無(wú)法滿足我們實(shí)際的業(yè)務(wù)要求，比如授信結(jié)果通知中不告訴客戶的授信到期時(shí)間，那么運(yùn)營(yíng)過(guò)程中就無(wú)法提前對(duì)客戶進(jìn)行貸后處理。這時(shí)就需要我們?nèi)ジ獠繙贤ㄔ黾踊騽h減字段。

例3：內(nèi)部跨組合作。風(fēng)控組的需求經(jīng)常會(huì)涉及到取金融組的數(shù)據(jù)。比如需要獲取客戶的在貸狀態(tài)。由于數(shù)據(jù)是金融組的，一般就需要金融組配合開(kāi)發(fā)提供此功能接口。產(chǎn)品經(jīng)理需要做的就是制定規(guī)則，在貸狀態(tài)有哪些？每種狀態(tài)的取值規(guī)則是什么？至于接口具體如何定義，如何實(shí)現(xiàn)與我們無(wú)瓜。

2.3 共享資源

相信大家都聽(tīng)過(guò)避免重復(fù)造輪子。其實(shí)就是要通過(guò)封裝接口去避免同樣的功能重復(fù)開(kāi)發(fā)。比如你要做一個(gè)打車(chē)平臺(tái)需要在APP上顯示地圖，那么如果從0到1開(kāi)發(fā)一套成熟的地圖系統(tǒng)的時(shí)間成本和資金成本是巨大的。

但是已經(jīng)有成熟的百度地圖為我們做好了，只需要在需要的時(shí)候調(diào)用他們的接口即可。這在B端行業(yè)中是非常常見(jiàn)的，經(jīng)常需要調(diào)用第三方服務(wù)商的接口去滿足業(yè)務(wù)需求。

以我司為例，在風(fēng)控系統(tǒng)中就需要每日定時(shí)獲取第三方服務(wù)商天眼查、百融（企業(yè)、個(gè)人數(shù)據(jù)提供商）的接口數(shù)據(jù)。這些數(shù)據(jù)我們自己內(nèi)部是肯定很難獲取到的。因此會(huì)按照接口調(diào)用次數(shù)去付費(fèi)合作。

在讀取接口文檔時(shí)要注意Array字段類型，Array是數(shù)組字符類型，可以理解為會(huì)有多條數(shù)據(jù)。那么在展示的時(shí)候通常就需要設(shè)計(jì)成列表形式的，而不能當(dāng)成是一條數(shù)據(jù)去進(jìn)行原型設(shè)計(jì)。

寫(xiě)在結(jié)尾

現(xiàn)在大家可能會(huì)比較理解定義中寫(xiě)到的“API接口的定義是一種規(guī)范或約定，用于描述軟件系統(tǒng)中不同組件之間的通信協(xié)議和數(shù)據(jù)交互方式。API接口定義了一組可用的操作、消息格式、數(shù)據(jù)結(jié)構(gòu)和參數(shù)，以及雙方之間如何進(jìn)行通信和交互。通過(guò)API接口，軟件系統(tǒng)的不同部分可以相互調(diào)用和協(xié)作，實(shí)現(xiàn)數(shù)據(jù)的傳遞、功能的調(diào)用和共享資源的訪問(wèn)，同時(shí)保持系統(tǒng)的安全性和穩(wěn)定性。”這一段話了。

在B端產(chǎn)品經(jīng)理的實(shí)際工作中掌握接口的定義及使用場(chǎng)景還是很有必要的。

以上是個(gè)人對(duì)于產(chǎn)品經(jīng)理眼中的接口的總結(jié)，歡迎大家補(bǔ)充指正。有有補(bǔ)充的特別好的我會(huì)重新更新文檔上傳。