OpenAPI，也稱(chēng)為開(kāi)放平臺(tái)，是服務(wù)型網(wǎng)站常見(jiàn)的一種應(yīng)用，在許多業(yè)務(wù)如海外倉(cāng)WMS業(yè)務(wù)中，OpenAPI平臺(tái)的存在就不容忽視。那么，產(chǎn)品經(jīng)理、尤其是不懂技術(shù)的產(chǎn)品經(jīng)理，要怎么參與搭建OpenAPI平臺(tái)？不妨一起來(lái)看看這篇文章，或許會(huì)對(duì)你有所啟發(fā)。

一、什么是OpenAPI平臺(tái)？

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

二、為什么需要OpenAPI平臺(tái)？

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

無(wú)OpenAPI的模式

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

B端究竟需要什么样的产品经理？

B端产品经理都是以提升供应侧的工作效率为目的，所以B端需求主要是以业务问题为导向。 这个是B端产品比较重要的一点，B端产品是服务于一个主体 ...

查看详情 >

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

有OpenAPI的模式

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

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

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

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

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

阿里奇門(mén)的作用說(shuō)明

隨著電子商務(wù)發(fā)展，商家所使用到的各類(lèi)軟件越來(lái)越多，各個(gè)軟件之間沒(méi)有相互打通，形成一個(gè)個(gè)信息孤島，給商家的使用帶來(lái)種種不便，商家要求各個(gè)系統(tǒng)之間的對(duì)接需求已經(jīng)越來(lái)越迫切。

目前在行業(yè)內(nèi)已經(jīng)有部分系統(tǒng)直接由服務(wù)商之間完成了系統(tǒng)軟件的對(duì)接，但是由于沒(méi)有統(tǒng)一的接入標(biāo)準(zhǔn)，導(dǎo)致接入較混亂，對(duì)接接口的版本也參差不齊，往往這樣的系統(tǒng)對(duì)接不具有可復(fù)制性，多個(gè)系統(tǒng)之間的對(duì)接，需要多次開(kāi)發(fā)，給商家的使用和功能迭代升級(jí)帶來(lái)了諸多的不便，同時(shí)也給服務(wù)商帶來(lái)額外的維護(hù)、開(kāi)發(fā)成本。

為了滿足商家需求，讓商家能夠突破各個(gè)業(yè)務(wù)系統(tǒng)之間的信息孤島，提升商家在各個(gè)系統(tǒng)之間的操作效率，解決各個(gè)系統(tǒng)之間標(biāo)準(zhǔn)化對(duì)接的痛點(diǎn)，我們推出了奇門(mén)項(xiàng)目。

奇門(mén)項(xiàng)目一期支持ERP、WMS 之間的系統(tǒng)標(biāo)準(zhǔn)化對(duì)接，通過(guò)構(gòu)建 ERP、 WMS 系統(tǒng)之間標(biāo)準(zhǔn)通信協(xié)議來(lái)實(shí)現(xiàn)不同系統(tǒng)之間的打通。對(duì)商家來(lái)說(shuō)，省去了更換系統(tǒng)軟件所帶來(lái)的額外開(kāi)發(fā)成本。對(duì) ISV 來(lái)說(shuō)，省去了與多家ERP、 WMS系統(tǒng)對(duì)接難的問(wèn)題，ERP通過(guò)一次對(duì)接奇門(mén)項(xiàng)目，打通與所有WMS之間的通信，WMS通過(guò)一次對(duì)接奇門(mén)項(xiàng)目，可以適配所有ERP軟件……

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

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

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

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

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

如果是搭建一個(gè)OpenAPI平臺(tái)，一般來(lái)說(shuō)會(huì)有兩個(gè)端，分別的：

1. 開(kāi)放平臺(tái)端（用戶端）
2. API管理后臺(tái)（管理端）

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

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

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

2. 用戶端的搭建

一般來(lái)說(shuō)開(kāi)放平臺(tái)的用戶端會(huì)分成這么幾個(gè)部分：

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

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

Shopee開(kāi)放平臺(tái)

谷倉(cāng)開(kāi)放平臺(tái)

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

4PX的開(kāi)發(fā)者工作臺(tái)

Shopee的開(kāi)發(fā)者控制中心

3. 后臺(tái)管理端的搭建

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

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

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

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

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

接口大師后臺(tái)管理系統(tǒng)

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

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

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

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

產(chǎn)品經(jīng)理怎么輸出接口文檔

關(guān)于產(chǎn)品經(jīng)理輸出接口文檔這件事，很多人都會(huì)有一個(gè)誤區(qū)，覺(jué)得這個(gè)東西是技術(shù)相關(guān)的內(nèi)容不需要自己參與過(guò)多。但是實(shí)際上從我的個(gè)人經(jīng)驗(yàn)來(lái)看，如果純粹由技術(shù)輸出接口文檔，對(duì)于接入方來(lái)說(shuō)非常痛苦，要么看不懂文檔，要么發(fā)現(xiàn)有些接口調(diào)不通，要么就發(fā)現(xiàn)文檔閱讀體驗(yàn)賊差等，對(duì)于開(kāi)放平臺(tái)方來(lái)說(shuō)可能是偷懶了，但是接入方的產(chǎn)品和研發(fā)往往就很痛苦了。

而且從API文檔也可以看得出對(duì)方的研發(fā)能力，一般小規(guī)模的技術(shù)團(tuán)隊(duì)或者整體能力偏差的技術(shù)團(tuán)隊(duì)，輸出的API文檔都比較爛，會(huì)讓客戶產(chǎn)生一些不信任感，感覺(jué)不安全。

所以我都是建議產(chǎn)品經(jīng)理要參與到開(kāi)放平臺(tái)或者開(kāi)放接口的搭建過(guò)程中去，要和技術(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é)任。

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

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

https://open.goodcang.com/（重點(diǎn)推薦）

https://open.4px.com/apiInfo/api

https://developer.winit.com.cn/

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

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

1. OpenAPI平臺(tái)

https://open.weixin.qq.com/

https://open.shopee.com/

https://open.lazada.com/

https://partner.tiktokshop.com/doc/page/63fd7444715d622a338c5097

2. 接口API的一些知識(shí)

https://juejin.cn/post/6987377856447774734

https://www.ruanyifeng.com/blog/2014/05/restful_api.html

https://www.ruanyifeng.com/blog/2019/04/oauth_design.html

http://www.yesx2.com/

https://www.imooc.com/learn/68/

3. 接口調(diào)試工具

https://www.bilibili.com/video/BV1ae4y1y7bf/?share_source=copy_web&vd_source=52af3a6250261fa8c6e13c736f8e3884