產(chǎn)品經(jīng)理不懂技術(shù)，該怎么搭建OpenAPI平臺項(xiàng)目？

本文是我編寫的電子書《跨境供應(yīng)鏈：海外倉OTWB項(xiàng)目實(shí)戰(zhàn)》第七章的第3篇文章，該電子書正在持續(xù)更新中。

部分關(guān)鍵內(nèi)容會設(shè)置為付費(fèi)閱讀，還有部分內(nèi)容會免費(fèi)更新在微信公眾號上。如果想要獲得更完整的、體系化的知識，建議私聊我付費(fèi)訂閱全文，目前的價格是￥88，預(yù)計在7月底之前會全部更新完成，8月份之后將會漲價至￥108。知識星球的成員可以獲得5折的優(yōu)惠，僅需￥43.99即可加入。

入門供應(yīng)鏈產(chǎn)品經(jīng)理最平滑的學(xué)習(xí)方式之一，非常值得一沖。

什么是OpenAPI平臺？

OpenAPI即開放API，也稱為開放平臺，是服務(wù)型網(wǎng)站常見的一種應(yīng)用，網(wǎng)站的服務(wù)商將自己的網(wǎng)站服務(wù)封裝成一系列API（Application Programming Interface，應(yīng)用編程接口）并搭建一個對外開放的平臺提供給第三方開發(fā)者使用，它提供了一套標(biāo)準(zhǔn)的API接口，讓不同的業(yè)務(wù)系統(tǒng)可以通過這些接口進(jìn)行交互和數(shù)據(jù)共享。這種行為就叫做開放網(wǎng)站的API，所開放的API就被稱作OpenAPI或者OpenAPI平臺。

為什么需要OpenAPI平臺？

在海外倉WMS業(yè)務(wù)中，其他上游系統(tǒng)可以通過OpenAPI與海外倉進(jìn)行數(shù)據(jù)交互和信息的傳遞，而不用從A系統(tǒng)導(dǎo)出數(shù)據(jù)，然后再登錄海外倉的系統(tǒng)再手動導(dǎo)入進(jìn)去，極大地提升了用戶的體驗(yàn)。

如果沒有OpenAPI的時候，用戶要將數(shù)據(jù)推送到海外倉WMS中，則需要從電商平臺或者電商ERP中手動導(dǎo)出業(yè)務(wù)數(shù)據(jù)，然后再登錄海外倉OMS，根據(jù)導(dǎo)入模板去填寫業(yè)務(wù)數(shù)據(jù)，最后再導(dǎo)入到OMS中，再通過OMS推送到WMS中。而且WMS作業(yè)完成之后，雖然OMS可以看到最新的業(yè)務(wù)狀態(tài)，但是由于沒有對外的API，所以外部的系統(tǒng)并不知道最新的狀態(tài)，還需要人工手動根據(jù)OMS的最新狀態(tài)（數(shù)據(jù)）去更新電商平臺或者電商ERP的狀態(tài)（數(shù)據(jù)）。

如果引入了OpenAPI之后，只需要電商平臺或者電商ERP和海外倉的OpenAPI完成了對接之后，這一切都不要手動去處理，系統(tǒng)可以自動完成相關(guān)的數(shù)據(jù)傳遞，包括上游系統(tǒng)主動推送給海外倉和海外倉反饋?zhàn)钚碌臄?shù)據(jù)給上游系統(tǒng)等。

OpenAPI和海外倉系統(tǒng)的交互示意圖

在前面海外倉OMS的章節(jié)有介紹過，在海外倉WMS領(lǐng)域中，OMS承擔(dān)的是一個客戶端的角色，也是WMS的上游端，所以一般來說外部系統(tǒng)是先通過OPenAPI這個通道觸達(dá)到OMS，然后再由OMS處理、轉(zhuǎn)化之后再推送到WMS中。幾乎很少有直接通過OpenAPI直接觸達(dá)WMS的玩法，海外倉領(lǐng)域中OMS和WMS一般都是配套出現(xiàn)的，很多業(yè)務(wù)邏輯都掛在OMS層面，當(dāng)然如果需要特殊定制讓OpenAPI的數(shù)據(jù)直接推送到WMS層也不是不可以，國內(nèi)倉的玩法就是這樣做的，稍后我們會進(jìn)行介紹。

要注意的是，文中提到的OpenAPI平臺是指海外倉作為提供方去建設(shè)的平臺，通俗點(diǎn)可以理解為是上游系統(tǒng)去接入海外倉WMS，而不是海外倉WMS去接入上游系統(tǒng)。所以，嚴(yán)格來說電商平臺并不是通過OpenAPI去接入海外倉OMS的，而是海外倉OMS通過電商平臺的OpenAPI去接入電商平臺，這個模式和電商ERP接入海外倉OMS是不太一樣的，剛好相反。

對于國內(nèi)倉WMS來說，由于各家的倉儲系統(tǒng)不太一樣，發(fā)展歷程也比較悠久，很多國內(nèi)倉都沒有對應(yīng)的OMS，而且京東，淘寶都分別做了相關(guān)的“業(yè)務(wù)系統(tǒng)標(biāo)準(zhǔn)化對接平臺”，例如阿里的奇門，京東的虎符等，所以在國內(nèi)電商領(lǐng)域，電商ERP會接入奇門，而國內(nèi)倉也會接入奇門，大多數(shù)場景下就不需要倉庫WMS單獨(dú)去提供額外的OpenAPI去給ERP接入了，除非是一些耦合性比較高的特殊需求。

隨著電子商務(wù)發(fā)展，商家所使用到的各類軟件越來越多，各個軟件之間沒有相互打通，形成一個個信息孤島，給商家的使用帶來種種不便，商家要求各個系統(tǒng)之間的對接需求已經(jīng)越來越迫切。目前在行業(yè)內(nèi)已經(jīng)有部分系統(tǒng)直接由服務(wù)商之間完成了系統(tǒng)軟件的對接，但是由于沒有統(tǒng)一的接入標(biāo)準(zhǔn)，導(dǎo)致接入較混亂，對接接口的版本也參差不齊，往往這樣的系統(tǒng)對接不具有可復(fù)制性，多個系統(tǒng)之間的對接，需要多次開發(fā)，給商家的使用和功能迭代升級帶來了諸多的不便，同時也給服務(wù)商帶來額外的維護(hù)、開發(fā)成本。為了滿足商家需求，讓商家能夠突破各個業(yè)務(wù)系統(tǒng)之間 的信息孤島，提升商家在各個系統(tǒng)之間的操作效率，解決各個系統(tǒng)之間標(biāo)準(zhǔn)化對接的痛點(diǎn)，我們推出了奇門項(xiàng)目。奇門項(xiàng)目一期支持ERP、WMS 之間的系統(tǒng)標(biāo)準(zhǔn)化對接，通過構(gòu)建 ERP、 WMS 系統(tǒng)之間標(biāo)準(zhǔn)通信協(xié)議來實(shí)現(xiàn)不同系統(tǒng)之間的打通。對商家來說，省去了更換系統(tǒng)軟件所帶來的額外開發(fā)成本。對 ISV 來說，省去了與多家ERP、 WMS系統(tǒng)對接難的問題，ERP通過一次對接奇門項(xiàng)目，打通與所有WMS之間的通信，WMS通過一次對接奇門項(xiàng)目，可以適配所有ERP軟件……

產(chǎn)品經(jīng)理如何去參與搭建OpenAPI

前面大概介紹了什么是OpenAPI，為什么需要OpenAPI，以及海外倉的OpenAPI背后是用OMS來承接相應(yīng)的數(shù)據(jù)，接下來就來介紹一下，作為產(chǎn)品經(jīng)理應(yīng)該怎么參與搭建OpenAPI。

很多人以為，OpenAPI是技術(shù)相關(guān)的事情，應(yīng)該全權(quán)交給技術(shù)去處理，自己壓根就不用管。但是這種想法是不對的，是片面的，對于OpenAPI的技術(shù)細(xì)節(jié)方面作為產(chǎn)品經(jīng)理確實(shí)可以不用參與，但是其它方面的內(nèi)容產(chǎn)品經(jīng)理都是需要去參與的。

不要把OpenAPI當(dāng)作一個技術(shù)名詞去理解，而是要把搭建OpenAPI平臺作為一個需求，作為一款產(chǎn)品去對待。去分析它的商業(yè)目標(biāo)是什么，用戶群體是誰，解決了什么問題，創(chuàng)造了什么價值。細(xì)化到具體的產(chǎn)品設(shè)計方案就是有多少套系統(tǒng)，有多少業(yè)務(wù)場景，有多少功能模塊，這些和做一款信息化系統(tǒng)并無二致。

1.OpenAPI平臺有哪些內(nèi)容需要搭建？

如果是搭建一個OpenAPI平臺，一般來說會有兩個端，分別的：

1. 開放平臺端（用戶端）
2. API管理后臺（管理端）

開放平臺端，也可以稱之為用戶端，用戶是指需要接入OpenAPI的開發(fā)者們，他們需要在OpenAPI平臺上查看API接口文檔，查看開放平臺的接入方式，查看自己申請的應(yīng)用APP和接口調(diào)用的情況等。

API管理后臺，也可以稱之為管理端，使用者是接口的提供商，例如海外倉需要對外提供開放平臺的接口，那么海外倉就需要搭建相關(guān)的API管理后臺，用來發(fā)布接口，審核開發(fā)者的資質(zhì)，還有監(jiān)控一些接口的日志等。

所以，當(dāng)產(chǎn)品經(jīng)理接收到了任務(wù)需要去搭建OpenAPI平臺之后，并不是說把這個事情簡單翻譯一下丟給技術(shù)人員就好了，實(shí)際上還是要把它當(dāng)作一個大的項(xiàng)目，大的需求，去做業(yè)務(wù)的分析和梳理，做競品的調(diào)研，做用戶畫像的梳理等。起碼要搞清楚有多少個端（系統(tǒng)），有多少功能模塊，有幾類使用的用戶等……

2.用戶端的搭建

一般來說開放平臺的用戶端會分成這么幾個部分：

1. API文檔
2. 接入指南/最佳實(shí)踐
3. 控制中心/工作臺

其中API文檔和接入指南一般都是直接對外開放的，訪問相關(guān)URL就可以直接訪問，不會做權(quán)限的控制。

而控制中心/工作臺則需要注冊成為了開發(fā)者，登錄賬號和密碼后才可以訪問，里面一般就是包含了自己的個人信息，接入的APP，還有一些接口調(diào)用日志，消息通知等。

3.后臺管理端的搭建

相較于用戶端來說，內(nèi)部管理端的競品非常不好找，因?yàn)檫@個內(nèi)容一般都是不對外開放的，所以這個時候產(chǎn)品經(jīng)理往往要想好另一條路：就是多和研發(fā)人員溝通，確認(rèn)一些技術(shù)需求，同時梳理出典型的業(yè)務(wù)場景，通過這些場景去設(shè)計內(nèi)部的管理端功能。

例如，如果需要在用戶端需要開發(fā)者入駐，那么開發(fā)者入駐的時候會填寫一些申請信息，后臺管理端就需要有開發(fā)者資質(zhì)審核的功能模塊。

同樣的，如果用戶端的開發(fā)者申請開通了一些APP應(yīng)用，也是需要后臺審核的，那么后臺管理端也需要有對應(yīng)的審核功能模塊。

然后前臺的一些API文檔和接入文檔等可能會不定期的更新，那么后臺管理端可能就需要有CMS（內(nèi)容管理系統(tǒng)）的功能模塊，這樣才可以快速地完成修改和更新。

針對技術(shù)部分的內(nèi)容，一些API的調(diào)用可能比較敏感，需要做費(fèi)用的計算，調(diào)用次數(shù)的限制，日志的統(tǒng)計，還有異常的監(jiān)控等，所以這些都需要在后臺管理端去完成。

4.業(yè)務(wù)接口的梳理

通過前面3個部分內(nèi)容的學(xué)習(xí)，我們知道了原來搭建一個OpenAPI平臺要做這么多事情，有這么多內(nèi)容，并不是想象中的做個“甩手掌柜”就夠了。

如果要從0開始去搭建一個OpenAPI平臺確實(shí)要做很多事情，OpenAPI搭建成本比較高，適用于有多個開發(fā)者要接入的場景，所以一般都是業(yè)務(wù)量到了一定量級之后才會去做這件事。如果目前只有少量的用戶需要接入海外倉系統(tǒng)，那么可以考慮用MVP的思路去實(shí)現(xiàn)，不是上來就搭建一個OpenAPI平臺，而是先搭建對外的技術(shù)接口，然后整理相關(guān)的說明，用一個在線文檔或者Word等方式交付。

如果是以MVP的方式去交付，作為產(chǎn)品經(jīng)理需要做的事情就稍微少一些，大概是下圖中的這么一些：

關(guān)于產(chǎn)品經(jīng)理輸出接口文檔這件事，很多人都會有一個誤區(qū)，覺得這個東西是技術(shù)相關(guān)的內(nèi)容不需要自己參與過多。但是實(shí)際上從我的個人經(jīng)驗(yàn)來看，如果純粹由技術(shù)輸出接口文檔，對于接入方來說非常痛苦，要么看不懂文檔，要么發(fā)現(xiàn)有些接口調(diào)不通，要么就發(fā)現(xiàn)文檔閱讀體驗(yàn)賊差等，對于開放平臺方來說可能是偷懶了，但是接入方的產(chǎn)品和研發(fā)往往就很痛苦了。而且從API文檔也可以看得出對方的研發(fā)能力，一般小規(guī)模的技術(shù)團(tuán)隊或者整體能力偏差的技術(shù)團(tuán)隊，輸出的API文檔都比較爛，會讓客戶產(chǎn)生一些不信任感，感覺不安全。

所以我都是建議產(chǎn)品經(jīng)理要參與到開放平臺或者開放接口的搭建過程中去，要和技術(shù)進(jìn)行協(xié)同，你不懂技術(shù)方面的東西那就交付給研發(fā)去搞定，但是體驗(yàn)方面的內(nèi)容、業(yè)務(wù)和邏輯的表達(dá)方面的內(nèi)容產(chǎn)品經(jīng)理是需要把關(guān)的，大家都是同為一體的，應(yīng)該共同為最后的交付結(jié)果（API功能和API文檔）承擔(dān)責(zé)任。

海外倉的OpenAPI需要開放哪些接口，這個是沒有標(biāo)準(zhǔn)的，需要結(jié)合實(shí)際的業(yè)務(wù)去選擇，這里我把行業(yè)內(nèi)做得比較好的一些友商的開放平臺整理了一下，大家可以直接看他們的接口文檔，對照學(xué)習(xí)和輸出即可。

其中做得最好的應(yīng)該是谷倉的開放平臺，整體的體驗(yàn)和邏輯說明都很優(yōu)秀，值得反復(fù)看看。

API對接方面的學(xué)習(xí)和提升

OpenAPI開放平臺這個項(xiàng)目說大也大，說小也小，和業(yè)務(wù)需求有直接的關(guān)系，但是考慮到后續(xù)大家肯定還是會有機(jī)會經(jīng)歷這一塊的，所以我整理了相關(guān)的學(xué)習(xí)資料和參考資料在文末，等后續(xù)要做這一塊業(yè)務(wù)的時候再翻出來查閱即可。

OpenAPI平臺

接口API的一些知識

接口調(diào)試工具