如何設(shè)計(jì)及管理開放平臺(tái)?

31 評(píng)論 56654 瀏覽 386 收藏 15 分鐘

本篇文章介紹了在從0到1設(shè)計(jì)過程中,需要考慮哪些環(huán)節(jié),搭建哪些基礎(chǔ)功能,以及如何進(jìn)行運(yùn)營(yíng)管理。

隨著技術(shù)和合作共享思維的發(fā)展,硅谷率先推出了開放平臺(tái),比如谷歌開放了map api,將自己的地圖能力進(jìn)行開放。

twitter開放了社交api,其他廠商,比如游戲等就可以直接調(diào)用twitter賬戶進(jìn)行登錄,同時(shí)關(guān)聯(lián)好友關(guān)系。國(guó)內(nèi)隨后也掀起了一場(chǎng)開放浪潮,逐漸開放了地圖、新聞門戶、電商、支付等很多行業(yè)的核心能力。

本次我們主要集中聊一聊一個(gè)開放平臺(tái)在從0到1設(shè)計(jì)過程中,我們需要考慮哪些環(huán)節(jié),我們需要搭建哪些基礎(chǔ)功能,以及我們?nèi)绾芜M(jìn)行運(yùn)營(yíng)管理。

一、為什么要搭建開放平臺(tái)?

通過開放自己平臺(tái)產(chǎn)品服務(wù)的各種API接口,讓其他第三方開發(fā)者在開發(fā)應(yīng)用時(shí)根據(jù)需求直接調(diào)用,例如微博登錄、支付寶支付,微信支付、酒店查詢預(yù)訂等等。

此種方式在我從業(yè)經(jīng)驗(yàn)中用的較多的其實(shí)是一些智能硬件設(shè)備廠商,將管理設(shè)備的能力開放給合作伙伴和客戶,幫助客戶或者合作伙伴能夠快速在自己系統(tǒng)中集成相應(yīng)的能力。

比如之前我在物業(yè)集團(tuán)做智慧社區(qū),涉及到智慧停車、智慧門禁、智慧安防、智慧對(duì)講,如果我們一個(gè)一個(gè)自己搭建,當(dāng)然是費(fèi)力費(fèi)事,如果我們借助于硬件廠商的開放平臺(tái),就可以快速在我們自己的系統(tǒng)搭建起相應(yīng)能力,作為廠商來(lái)說,他們就成功將自己的服務(wù)能力提供給了我們,提升了他們的品牌效力,同時(shí)加強(qiáng)了產(chǎn)品競(jìng)爭(zhēng)力。

備注:部分情況下,也可以開放H5給第三方,此種情況下第三方不需要再進(jìn)行頁(yè)面和后臺(tái)開發(fā),只需要根據(jù)平臺(tái)方要求傳入相應(yīng)的參數(shù)即可。

二、開放平臺(tái)服務(wù)形式

開放平臺(tái)主要是將自己的資源或者服務(wù)通過API、H5的形式開放給第三方合作伙伴或者客戶進(jìn)行對(duì)接,幫助他們快速構(gòu)建自己的某一項(xiàng)應(yīng)用。

從形式上來(lái)說,大致分為兩類:

1. 開發(fā)者請(qǐng)求時(shí),開放平臺(tái)返回對(duì)應(yīng)的H5鏈接,在這種形式下,通常是開發(fā)者傳入自己系統(tǒng)的用戶賬戶信息,然后直接在開放平臺(tái)的H5鏈接內(nèi)進(jìn)行服務(wù)。這種形式的開放在支付寶的服務(wù)中就有很多,比如社保公積金查詢、汽車服務(wù)等。

優(yōu)勢(shì):對(duì)于開發(fā)者來(lái)說,開發(fā)成本極低,基本上沒有什么開發(fā)量,上線時(shí)間更快,且無(wú)需詳細(xì)了解對(duì)應(yīng)業(yè)務(wù)的邏輯及規(guī)則等。對(duì)于平臺(tái)方來(lái)說,也更簡(jiǎn)單,不用重復(fù)和不同的開發(fā)者進(jìn)行接口聯(lián)調(diào)。

劣勢(shì):開發(fā)者無(wú)法直接獲取自己系統(tǒng)用戶實(shí)際的業(yè)務(wù)情況,比如下單量、下單金額等,完全依靠平臺(tái)提供的數(shù)據(jù);相應(yīng)的頁(yè)面的風(fēng)格無(wú)法變更,可能存在不符合自身系統(tǒng)風(fēng)格風(fēng)險(xiǎn);

2. 開發(fā)者請(qǐng)求時(shí),根據(jù)API的函數(shù)傳入對(duì)應(yīng)的參數(shù),平臺(tái)返回對(duì)應(yīng)的數(shù)據(jù)內(nèi)容,開發(fā)者再將內(nèi)容進(jìn)行整合后按照自己的風(fēng)格進(jìn)行呈現(xiàn)。

優(yōu)勢(shì):開發(fā)者可以按照自己系統(tǒng)的設(shè)計(jì)規(guī)范進(jìn)行呈現(xiàn),使用戶無(wú)法感知相關(guān)的資源和服務(wù)是第三方平臺(tái)提供的。對(duì)于有交易類型及分成的業(yè)務(wù),開發(fā)者可以自己掌握相關(guān)訂單數(shù)據(jù),不用完全受制于平臺(tái)方提供的數(shù)據(jù);

劣勢(shì):開發(fā)成本相對(duì)較高,開發(fā)者需要詳細(xì)了解業(yè)務(wù)規(guī)則及邏輯,同時(shí)還要進(jìn)行前端頁(yè)面設(shè)計(jì)和開發(fā);平臺(tái)技術(shù)方,需要對(duì)接開發(fā)者的接口聯(lián)調(diào)及問題解釋,對(duì)于人力資源的投入相對(duì)來(lái)說更高;

綜合起來(lái)看,也不一定能說哪種形式更好,具體的需要結(jié)合實(shí)際情況來(lái)定自己的開放平臺(tái)采用哪些形式進(jìn)行開放。合作關(guān)系、業(yè)務(wù)模式、團(tuán)隊(duì)情況、業(yè)務(wù)發(fā)展階段、系統(tǒng)穩(wěn)定性等都是考慮的因素,最后詳細(xì)擬定采用哪種或者多種形式;

三、開放平臺(tái)設(shè)計(jì)

本次我們主要說一說API方式的開放平臺(tái)設(shè)計(jì),其中屬于企業(yè)服務(wù)類型的,主要需求符合智能硬件廠商開放平臺(tái)的設(shè)計(jì)需求,與支付寶、微信類型的標(biāo)準(zhǔn)接入型開放平臺(tái)有差異。主要從產(chǎn)品需求層面進(jìn)行剖析,從需求引申到功能,不涉及具體技術(shù)層面。

開放平臺(tái)主要解決以下幾個(gè)層面的需求:

  1. 開發(fā)者身份注冊(cè)與數(shù)據(jù)權(quán)限范圍授權(quán)
  2. 開發(fā)者獲取相關(guān)資料(接口文檔、使用說明、對(duì)接人聯(lián)系方式等)
  3. 平臺(tái)方內(nèi)部管理,申請(qǐng)審核流程、服務(wù)配置、業(yè)務(wù)交易管理、參數(shù)配置、人員分配等
  4. 業(yè)務(wù)交易管理及統(tǒng)計(jì)報(bào)表分析(涉及雙方需要結(jié)算的類型)
  5. 安全層面需求,加密、應(yīng)用秘鑰、應(yīng)用接口權(quán)限控制、訪問黑白名單、字段脫敏還原等

結(jié)合針對(duì)需求的分析,我們整理了一下開放平臺(tái)的基礎(chǔ)功能的清單,主要是針對(duì)開發(fā)者、內(nèi)部管理員的,其次是基于安全層面的一些功能需求。

1. 開發(fā)者門戶

通常情況下,開放平臺(tái)會(huì)掛在公司的官網(wǎng)上某個(gè)入口,當(dāng)然有些時(shí)候也會(huì)放在一個(gè)特定的門戶地址。開發(fā)者門戶主要是幫助用戶在平臺(tái)進(jìn)行注冊(cè)、申請(qǐng)接入、查詢審核進(jìn)度、查看相關(guān)接入?yún)?shù)、下載文檔等,接入成功并上線后,查看一些運(yùn)營(yíng)數(shù)據(jù),方便與平臺(tái)方進(jìn)行對(duì)賬。

注冊(cè)&接入申請(qǐng):開發(fā)者通過公司名稱、手機(jī)號(hào)或者郵箱進(jìn)行賬號(hào)注冊(cè),注冊(cè)后即可以填寫接入申請(qǐng),申請(qǐng)單內(nèi)容一般主要包含接入需求描述、關(guān)聯(lián)項(xiàng)目、聯(lián)系人(平臺(tái)方,一般是商務(wù)人員)、申請(qǐng)方聯(lián)系人及聯(lián)系方式、接入模式、費(fèi)用、申請(qǐng)類型等等;

備注:關(guān)于費(fèi)用問題一定要描述清楚,有些合作伙伴需要定制開發(fā),通常是需要收費(fèi)的,一般是標(biāo)準(zhǔn)API接入免費(fèi),定制化需求及定制化系統(tǒng)開發(fā)需要收取費(fèi)用(有些合作伙伴會(huì)有開發(fā)需求);

進(jìn)度查看&參數(shù)獲?。?/strong>申請(qǐng)?zhí)峤缓?,開發(fā)者可以在線查看申請(qǐng)進(jìn)度,審核成功后即可查看相關(guān)接入?yún)?shù),如果審核不成功可以重新修改后提交;

下載相關(guān)文檔:開發(fā)者可以自助下載相關(guān)接口文檔及其他說明文檔;

業(yè)務(wù)交易管理:針對(duì)開放的業(yè)務(wù)不同涉及的內(nèi)容不同,對(duì)于有訂單業(yè)務(wù)或者付費(fèi)服務(wù)的業(yè)務(wù)來(lái)說,需要進(jìn)行交易管理,主要是查看交易、對(duì)賬、結(jié)算等基礎(chǔ)功能;

統(tǒng)計(jì)報(bào)表:主要是根據(jù)開發(fā)者的業(yè)務(wù)類型,提供相關(guān)業(yè)務(wù)的一些數(shù)據(jù)報(bào)表,比如訂單數(shù)量、變化趨勢(shì)、用戶數(shù)據(jù)等等,具體結(jié)合開放的業(yè)務(wù)擬定;

2. 開放平臺(tái)內(nèi)管系統(tǒng)

開放平臺(tái)內(nèi)管系統(tǒng),主要是解決內(nèi)部商務(wù)人員對(duì)需求的補(bǔ)充,相關(guān)部門負(fù)責(zé)人對(duì)接入需求的審核、系統(tǒng)管理員對(duì)參數(shù)配置以及服務(wù)管理等,同時(shí)也管理相關(guān)對(duì)接人員制定及運(yùn)營(yíng)管理部分的配置和查看等。

接入申請(qǐng)審核&參數(shù)配置:內(nèi)部相關(guān)人員對(duì)開發(fā)者申請(qǐng)需求進(jìn)行審批,審批成功后執(zhí)行的人員對(duì)參數(shù)進(jìn)行配置并制定對(duì)接人負(fù)責(zé)后續(xù)接口聯(lián)調(diào)及相關(guān)問題解答;

運(yùn)營(yíng)管理:主要是對(duì)交易類型訂單的管理及對(duì)賬,同時(shí)管理相關(guān)報(bào)表數(shù)據(jù)的需求,進(jìn)行配置;

3. 安全機(jī)制

安全機(jī)制中主要是對(duì)開發(fā)者賬號(hào)及權(quán)限進(jìn)行管理,訪問次數(shù)流量監(jiān)控,IP地址管控,黑白名單管控等,其中針對(duì)公司人員變動(dòng)問題,對(duì)于訪問服務(wù)器地址控制是比較重要的。

四、接口設(shè)計(jì)

開放平臺(tái)的功能基本上說清楚了,還有一個(gè)細(xì)分部分我們單獨(dú)拉出來(lái)說一下,就是接口的設(shè)計(jì)。

通常情況下,開放的相關(guān)服務(wù)我們自己的系統(tǒng)已經(jīng)進(jìn)行引用,并且有相應(yīng)的接口函數(shù),但是不能直接用,因?yàn)樽鳛槠脚_(tái)服務(wù)方,我們由于版本問題及一些歷史原因等可能存在一些歷史遺留問題,作為開放平臺(tái)對(duì)外輸出的接口我們應(yīng)該關(guān)注并處理一下幾個(gè)方面:

1. 對(duì)接口的整合

對(duì)于一些比較復(fù)雜的無(wú)用的字段一定要進(jìn)行刪除,避免給開發(fā)者造成不必要困擾

2. 對(duì)各版本系統(tǒng)兼容性

這個(gè)主要針對(duì)的是有些廠商,設(shè)備前端軟件版本不同,造成參數(shù)內(nèi)容范圍統(tǒng)計(jì)不完善的情況,云平臺(tái)一定要進(jìn)行整合兼容。

比如停場(chǎng)場(chǎng)景下,前端停車管理軟件歷史性版本中返給云平臺(tái)的車輛狀態(tài)碼有20種,但是云平臺(tái)對(duì)外開放時(shí)只考慮到了10種狀態(tài)碼(或許是本來(lái)就只有10種狀態(tài)),而這樣在實(shí)際運(yùn)行中,如果云平臺(tái)只是做一個(gè)透?jìng)鳑]有做兼容,那么就有可能第三方系統(tǒng)獲取到了未知狀態(tài)碼(接口文檔上沒有),從而造成第三方開發(fā)者設(shè)計(jì)的系統(tǒng)存在缺陷。

3. 協(xié)議適配

提供服務(wù)的可能是一些老舊的系統(tǒng),報(bào)文格式可能是XML、定長(zhǎng)報(bào)文等,這時(shí)就需要對(duì)不同協(xié)議的報(bào)文進(jìn)行適配轉(zhuǎn)化,形成統(tǒng)一

五、開放平臺(tái)管理

開放平臺(tái)設(shè)計(jì)好后,還需要進(jìn)行良好的運(yùn)營(yíng)管理,才能發(fā)揮開放平臺(tái)應(yīng)有的用途,同時(shí)增強(qiáng)公司的品牌力量及核心競(jìng)爭(zhēng)力。

首先我們來(lái)看一下一個(gè)案例,我梳理的一個(gè)開放平臺(tái)的對(duì)接流程圖:

接入對(duì)接的各個(gè)環(huán)節(jié)流程,基本上就是上面這個(gè)流程圖所示,下面主要講解幾個(gè)注意事項(xiàng):

1. 開發(fā)者提交申請(qǐng)后,通常建議是售前或者商務(wù)人員進(jìn)行審核和補(bǔ)充,其中包括客戶的價(jià)值、項(xiàng)目?jī)r(jià)值,費(fèi)用核算等,因?yàn)榭蛻籼顚懙男枨笸ǔV粫?huì)設(shè)計(jì)功能及使用層面。公司前端銷售人員填寫的資料有助于審核通過,公司項(xiàng)目管控肯定是基于銷售情況,比如有訂單的優(yōu)先、高價(jià)值客戶優(yōu)先等

2. 審核負(fù)責(zé)人一般包含兩部分,一個(gè)是市場(chǎng)端的負(fù)責(zé)人審核,便于后期對(duì)公司內(nèi)部做結(jié)算管理一個(gè)是技術(shù)支撐端負(fù)責(zé)人審核,主要是需求明確及工作量和費(fèi)用

備注:關(guān)于審核,前端銷售容易什么需求都接,也不太考慮相關(guān)成本,因此平臺(tái)公司最好建立良好的成本管控意識(shí)及機(jī)制,并且在審核時(shí)涉及工作量的一定要反饋給前端,不然容易造成什么需求都在接,接了后實(shí)際并沒有對(duì)公司整體業(yè)務(wù)有太大價(jià)值,或者技術(shù)支撐人員疲于第三方的對(duì)接。

3. 配置參數(shù)后,通??梢灾苯訉⑾嚓P(guān)的技術(shù)對(duì)接人在平臺(tái)給到開發(fā)者,相關(guān)問題可以直接溝通。當(dāng)項(xiàng)目啟動(dòng)后,也可以平臺(tái)方前端人員將兩方的相關(guān)人員一并拉在一個(gè)群里面進(jìn)行溝通。平臺(tái)方技術(shù)人員也需要具備客戶意識(shí),盡量尊重和有禮有節(jié)的處理客戶需求。

4. 在測(cè)試環(huán)境通過后,開發(fā)者可以發(fā)起正式環(huán)境上線申請(qǐng),平臺(tái)方配置相關(guān)參數(shù),開發(fā)者進(jìn)行生產(chǎn)環(huán)境發(fā)布

5. 發(fā)布后,開發(fā)者的運(yùn)營(yíng)及財(cái)務(wù)就需要介入了,進(jìn)行數(shù)據(jù)查看及訂單對(duì)賬結(jié)算等

六、后記

至此呢,基本上就將一個(gè)智能硬件廠商的開放平臺(tái)的設(shè)計(jì)和管理總結(jié)清楚了,當(dāng)然本方案其實(shí)也適用于一些其他行業(yè)或者系統(tǒng),希望對(duì)同行有一點(diǎn)點(diǎn)啟發(fā),同時(shí)如有不正確之處,歡迎指正和交流!

2019年回歸物聯(lián)網(wǎng),我們一起成長(zhǎng),春季期間將陸續(xù)整理相關(guān)總結(jié)及知識(shí)進(jìn)行分析,盡請(qǐng)持續(xù)關(guān)注!

 

作者:Kent,微信公眾號(hào):Liuke2019

本文由 @Kent 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載

題圖來(lái)自Unsplash,基于CC0協(xié)議

更多精彩內(nèi)容,請(qǐng)關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號(hào)或下載App
評(píng)論
評(píng)論請(qǐng)登錄
  1. 目前在做政府端的開放平臺(tái),是否可以交流學(xué)習(xí)

    來(lái)自廣東 回復(fù)
  2. 寫得很好,讓我對(duì)開放平臺(tái)有了一個(gè)整體的認(rèn)識(shí)。

    來(lái)自浙江 回復(fù)
  3. 寫的很棒,有很多共性的思路

    來(lái)自廣東 回復(fù)
  4. 感謝分享,有學(xué)習(xí)到。

    來(lái)自安徽 回復(fù)
  5. 麻煩咨詢開放平臺(tái)的參數(shù)和返回結(jié)果,以及釋義的這些維護(hù)也是在內(nèi)部管理系統(tǒng)里實(shí)現(xiàn)的么,也是有可視化的網(wǎng)站進(jìn)行操作么

    來(lái)自四川 回復(fù)
  6. 最近在做開放平臺(tái),文章很有借鑒意義,請(qǐng)教一下,做開發(fā)平臺(tái)的開發(fā)者門戶、開放者內(nèi)部管理系統(tǒng)、安全機(jī)制,這三者先有先后順序么?方便的話,可以weixin詳細(xì)請(qǐng)教嗎?

    來(lái)自北京 回復(fù)
    1. 可以加微信互相交流么,最近也在設(shè)計(jì)開放平臺(tái)

      來(lái)自河北 回復(fù)
    2. 我最近也再設(shè)計(jì)開放平臺(tái)

      來(lái)自重慶 回復(fù)
    3. 可以交流嗎

      來(lái)自廣東 回復(fù)
  7. 爆贊,目前正準(zhǔn)備學(xué)習(xí)和設(shè)計(jì)保險(xiǎn)開放平臺(tái),有幫助,可以私聊學(xué)習(xí)否

    來(lái)自北京 回復(fù)
    1. 以前就是做保險(xiǎn)開放平臺(tái)的,有空可以私聊我

      來(lái)自日本 回復(fù)
    2. 我的微信zz17621374354

      來(lái)自河北 回復(fù)
  8. 不錯(cuò)不錯(cuò),剛好需要了解

    來(lái)自廣東 回復(fù)
  9. 請(qǐng)問短信平臺(tái)能做開放平臺(tái)嗎

    回復(fù)
    1. 肯定可以的,對(duì)外開放短信能力,比如發(fā)送短信、查看短信記錄(發(fā)送成功/失?。┑鹊?,可參考騰訊的短信平臺(tái)。

      來(lái)自新加坡 回復(fù)
  10. 參數(shù)這塊能詳細(xì)一點(diǎn)就好了,這塊不是很懂,估計(jì)和后端技術(shù)掛勾?

    來(lái)自福建 回復(fù)
  11. 說的非常清晰,還是有一些細(xì)節(jié),方便私信交流一下嗎

    來(lái)自北京 回復(fù)
  12. 說的很明白了

    來(lái)自浙江 回復(fù)
  13. 服務(wù)管理和參數(shù)管理的區(qū)別是什么?

    來(lái)自廣東 回復(fù)
  14. 方便私信交流一下嗎?

    來(lái)自廣東 回復(fù)
  15. 寫的非常真實(shí)貼切 ?? ,最近正好在做開放平臺(tái)的產(chǎn)品設(shè)計(jì),請(qǐng)問方便私信交流嗎?

    來(lái)自上海 回復(fù)
    1. liu58liu

      來(lái)自四川 回復(fù)
    2. 請(qǐng)問可以加你微信私聊嗎

      來(lái)自河北 回復(fù)
  16. 講的通俗易懂,贊一個(gè)

    來(lái)自廣東 回復(fù)
    1. ??

      來(lái)自四川 回復(fù)
  17. 學(xué)習(xí)了,贊一個(gè)!

    來(lái)自內(nèi)蒙古 回復(fù)
  18. 學(xué)習(xí)了。講得非常棒。

    回復(fù)
  19. 贊一個(gè),另外想問下測(cè)試和正式發(fā)布的賬戶體系時(shí)怎么設(shè)計(jì)的呢

    來(lái)自廣東 回復(fù)
    1. 同一個(gè)賬號(hào) 不同參數(shù)

      來(lái)自廣東 回復(fù)
  20. 贊一個(gè)~

    來(lái)自浙江 回復(fù)
  21. 這么好的,把開放平臺(tái)講明白的文章居然沒有人回復(fù)?

    來(lái)自北京 回復(fù)