B端產品不得不知的API接口
API接口對于B端產品經理來說是個再熟悉不過的詞匯了。雖然它是技術范疇的東西,但作為B端產品經理如果不懂得它的使用場景和解讀方法,在實際工作中是很難順利完成產品方案的。因此本文將重點探討API的使用場景,及在不同場景下產品經理如何解讀API接口去順利完成產品工作。
一、API接口是什么
“接口”這一詞應該是B端產品經理日常和開發溝通最多的詞匯之一了,經常聽到接口文檔、接口聯調等等。API接口的定義是一種規范或約定,用于描述軟件系統中不同組件之間的通信協議和數據交互方式。API接口定義了一組可用的操作、消息格式、數據結構和參數,以及雙方之間如何進行通信和交互。通過API接口,軟件系統的不同部分可以相互調用和協作,實現數據的傳遞、功能的調用和共享資源的訪問,同時保持系統的安全性和穩定性。(一堆官方廢話,先不用管往下看)
接口在形式上由四部分構成:方法(get,post等)、url(請求地址)、請求參數、返回參數
在功能實現上由三個主要部分構成:輸入,邏輯處理,輸出。(產品需要關注的)
二、API的主要作用
2.1 前后端數據傳遞和功能調用的橋梁
接口聯調是前后端開發工作中很重要的一部分,現在都采用前端后端分離的開發模式。通常來說在接收到產品需求后,后端會先定義好接口文檔給到前端,前端在完成界面展示的代碼編寫,后端完成了接口的邏輯處理就需要開始進行聯調,以確保接口能夠從輸入到輸出的正常運作。
以新增客戶為例:新增客戶接口的功能就是把用戶輸入的客戶信息寫入到數據庫中。接口輸入:客戶信息。邏輯處理:是否可以新增成功?(這里面涉及的規則就需要產品經理來確定)輸出:返回前端處理結果。
產品涉及工作:接口在前后端的應用一般不需要產品經理特別關注接口本身,產品經理需要重點關注的是規則的制定。也是后端經常跟我說的實現肯定是可以實現,但你要定個規則給我。
2.2 系統對接
在B端工作中經常會涉及到跨系統的需求對接,比如我從事的供應鏈金融領域會經常涉及到與資方進行系統對接共同實現客戶的借貸全生命周期的系統流程。那么跨系統交互的重要工具正是API接口。下圖為我司查詢客戶授信結果流程圖和接口(輸入:客戶編號 邏輯判斷:客戶是否滿足授信通過規則 輸出:客戶授信狀態、授信時間等)。
產品涉及工作:在系統對接需求中,可能就會涉及到產品經理對于接口的應用。重點需要關注接口中的請求參數和響應參數。
例1:資方需要我們在客戶授信流程中提供客戶信息,那么資方會出具一份客戶授信信息接口,產品經理就需要明確這份接口中資方想要的是哪些字段信息,我們在系統什么節點調用此接口,這些信息如何獲取等等。
例2:上述例子是需要產品向外部系統提供數據,那么反過來也會涉及到向外部系統要數據。那么往往有時候我們會發現外部提供的接口字段數據無法滿足我們實際的業務要求,比如授信結果通知中不告訴客戶的授信到期時間,那么運營過程中就無法提前對客戶進行貸后處理。這時就需要我們去跟外部溝通增加或刪減字段。
例3:內部跨組合作。風控組的需求經常會涉及到取金融組的數據。比如需要獲取客戶的在貸狀態。由于數據是金融組的,一般就需要金融組配合開發提供此功能接口。產品經理需要做的就是制定規則,在貸狀態有哪些?每種狀態的取值規則是什么?至于接口具體如何定義,如何實現與我們無瓜。
2.3 共享資源
相信大家都聽過避免重復造輪子。其實就是要通過封裝接口去避免同樣的功能重復開發。比如你要做一個打車平臺需要在APP上顯示地圖,那么如果從0到1開發一套成熟的地圖系統的時間成本和資金成本是巨大的。
但是已經有成熟的百度地圖為我們做好了,只需要在需要的時候調用他們的接口即可。這在B端行業中是非常常見的,經常需要調用第三方服務商的接口去滿足業務需求。
以我司為例,在風控系統中就需要每日定時獲取第三方服務商天眼查、百融(企業、個人數據提供商)的接口數據。這些數據我們自己內部是肯定很難獲取到的。因此會按照接口調用次數去付費合作。
在讀取接口文檔時要注意Array字段類型,Array是數組字符類型,可以理解為會有多條數據。那么在展示的時候通常就需要設計成列表形式的,而不能當成是一條數據去進行原型設計。
寫在結尾
現在大家可能會比較理解定義中寫到的“API接口的定義是一種規范或約定,用于描述軟件系統中不同組件之間的通信協議和數據交互方式。API接口定義了一組可用的操作、消息格式、數據結構和參數,以及雙方之間如何進行通信和交互。通過API接口,軟件系統的不同部分可以相互調用和協作,實現數據的傳遞、功能的調用和共享資源的訪問,同時保持系統的安全性和穩定性?!边@一段話了。
在B端產品經理的實際工作中掌握接口的定義及使用場景還是很有必要的。
以上是個人對于產品經理眼中的接口的總結,歡迎大家補充指正。有有補充的特別好的我會重新更新文檔上傳。
本文由 @B端阿超 原創發布于人人都是產品經理。未經許可,禁止轉載
題圖來自Unsplash,基于 CC0 協議
該文觀點僅代表作者本人,人人都是產品經理平臺僅提供信息存儲空間服務。
- 目前還沒評論,等你發揮!