B端產(chǎn)品不得不知的API接口
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ì)重新更新文檔上傳。
本文由 @B端阿超 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載
題圖來(lái)自Unsplash,基于 CC0 協(xié)議
該文觀點(diǎn)僅代表作者本人,人人都是產(chǎn)品經(jīng)理平臺(tái)僅提供信息存儲(chǔ)空間服務(wù)。
- 目前還沒(méi)評(píng)論,等你發(fā)揮!