如何設計及管理開放平臺?
本篇文章介紹了在從0到1設計過程中,需要考慮哪些環(huán)節(jié),搭建哪些基礎功能,以及如何進行運營管理。
隨著技術和合作共享思維的發(fā)展,硅谷率先推出了開放平臺,比如谷歌開放了map api,將自己的地圖能力進行開放。
twitter開放了社交api,其他廠商,比如游戲等就可以直接調(diào)用twitter賬戶進行登錄,同時關聯(lián)好友關系。國內(nèi)隨后也掀起了一場開放浪潮,逐漸開放了地圖、新聞門戶、電商、支付等很多行業(yè)的核心能力。
本次我們主要集中聊一聊一個開放平臺在從0到1設計過程中,我們需要考慮哪些環(huán)節(jié),我們需要搭建哪些基礎功能,以及我們?nèi)绾芜M行運營管理。
一、為什么要搭建開放平臺?
通過開放自己平臺產(chǎn)品服務的各種API接口,讓其他第三方開發(fā)者在開發(fā)應用時根據(jù)需求直接調(diào)用,例如微博登錄、支付寶支付,微信支付、酒店查詢預訂等等。
此種方式在我從業(yè)經(jīng)驗中用的較多的其實是一些智能硬件設備廠商,將管理設備的能力開放給合作伙伴和客戶,幫助客戶或者合作伙伴能夠快速在自己系統(tǒng)中集成相應的能力。
比如之前我在物業(yè)集團做智慧社區(qū),涉及到智慧停車、智慧門禁、智慧安防、智慧對講,如果我們一個一個自己搭建,當然是費力費事,如果我們借助于硬件廠商的開放平臺,就可以快速在我們自己的系統(tǒng)搭建起相應能力,作為廠商來說,他們就成功將自己的服務能力提供給了我們,提升了他們的品牌效力,同時加強了產(chǎn)品競爭力。
備注:部分情況下,也可以開放H5給第三方,此種情況下第三方不需要再進行頁面和后臺開發(fā),只需要根據(jù)平臺方要求傳入相應的參數(shù)即可。
二、開放平臺服務形式
開放平臺主要是將自己的資源或者服務通過API、H5的形式開放給第三方合作伙伴或者客戶進行對接,幫助他們快速構建自己的某一項應用。
從形式上來說,大致分為兩類:
1. 開發(fā)者請求時,開放平臺返回對應的H5鏈接,在這種形式下,通常是開發(fā)者傳入自己系統(tǒng)的用戶賬戶信息,然后直接在開放平臺的H5鏈接內(nèi)進行服務。這種形式的開放在支付寶的服務中就有很多,比如社保公積金查詢、汽車服務等。
優(yōu)勢:對于開發(fā)者來說,開發(fā)成本極低,基本上沒有什么開發(fā)量,上線時間更快,且無需詳細了解對應業(yè)務的邏輯及規(guī)則等。對于平臺方來說,也更簡單,不用重復和不同的開發(fā)者進行接口聯(lián)調(diào)。
劣勢:開發(fā)者無法直接獲取自己系統(tǒng)用戶實際的業(yè)務情況,比如下單量、下單金額等,完全依靠平臺提供的數(shù)據(jù);相應的頁面的風格無法變更,可能存在不符合自身系統(tǒng)風格風險;
2. 開發(fā)者請求時,根據(jù)API的函數(shù)傳入對應的參數(shù),平臺返回對應的數(shù)據(jù)內(nèi)容,開發(fā)者再將內(nèi)容進行整合后按照自己的風格進行呈現(xiàn)。
優(yōu)勢:開發(fā)者可以按照自己系統(tǒng)的設計規(guī)范進行呈現(xiàn),使用戶無法感知相關的資源和服務是第三方平臺提供的。對于有交易類型及分成的業(yè)務,開發(fā)者可以自己掌握相關訂單數(shù)據(jù),不用完全受制于平臺方提供的數(shù)據(jù);
劣勢:開發(fā)成本相對較高,開發(fā)者需要詳細了解業(yè)務規(guī)則及邏輯,同時還要進行前端頁面設計和開發(fā);平臺技術方,需要對接開發(fā)者的接口聯(lián)調(diào)及問題解釋,對于人力資源的投入相對來說更高;
綜合起來看,也不一定能說哪種形式更好,具體的需要結合實際情況來定自己的開放平臺采用哪些形式進行開放。合作關系、業(yè)務模式、團隊情況、業(yè)務發(fā)展階段、系統(tǒng)穩(wěn)定性等都是考慮的因素,最后詳細擬定采用哪種或者多種形式;
三、開放平臺設計
本次我們主要說一說API方式的開放平臺設計,其中屬于企業(yè)服務類型的,主要需求符合智能硬件廠商開放平臺的設計需求,與支付寶、微信類型的標準接入型開放平臺有差異。主要從產(chǎn)品需求層面進行剖析,從需求引申到功能,不涉及具體技術層面。
開放平臺主要解決以下幾個層面的需求:
- 開發(fā)者身份注冊與數(shù)據(jù)權限范圍授權
- 開發(fā)者獲取相關資料(接口文檔、使用說明、對接人聯(lián)系方式等)
- 平臺方內(nèi)部管理,申請審核流程、服務配置、業(yè)務交易管理、參數(shù)配置、人員分配等
- 業(yè)務交易管理及統(tǒng)計報表分析(涉及雙方需要結算的類型)
- 安全層面需求,加密、應用秘鑰、應用接口權限控制、訪問黑白名單、字段脫敏還原等
結合針對需求的分析,我們整理了一下開放平臺的基礎功能的清單,主要是針對開發(fā)者、內(nèi)部管理員的,其次是基于安全層面的一些功能需求。
1. 開發(fā)者門戶
通常情況下,開放平臺會掛在公司的官網(wǎng)上某個入口,當然有些時候也會放在一個特定的門戶地址。開發(fā)者門戶主要是幫助用戶在平臺進行注冊、申請接入、查詢審核進度、查看相關接入?yún)?shù)、下載文檔等,接入成功并上線后,查看一些運營數(shù)據(jù),方便與平臺方進行對賬。
注冊&接入申請:開發(fā)者通過公司名稱、手機號或者郵箱進行賬號注冊,注冊后即可以填寫接入申請,申請單內(nèi)容一般主要包含接入需求描述、關聯(lián)項目、聯(lián)系人(平臺方,一般是商務人員)、申請方聯(lián)系人及聯(lián)系方式、接入模式、費用、申請類型等等;
備注:關于費用問題一定要描述清楚,有些合作伙伴需要定制開發(fā),通常是需要收費的,一般是標準API接入免費,定制化需求及定制化系統(tǒng)開發(fā)需要收取費用(有些合作伙伴會有開發(fā)需求);
進度查看&參數(shù)獲?。?/strong>申請?zhí)峤缓?,開發(fā)者可以在線查看申請進度,審核成功后即可查看相關接入?yún)?shù),如果審核不成功可以重新修改后提交;
下載相關文檔:開發(fā)者可以自助下載相關接口文檔及其他說明文檔;
業(yè)務交易管理:針對開放的業(yè)務不同涉及的內(nèi)容不同,對于有訂單業(yè)務或者付費服務的業(yè)務來說,需要進行交易管理,主要是查看交易、對賬、結算等基礎功能;
統(tǒng)計報表:主要是根據(jù)開發(fā)者的業(yè)務類型,提供相關業(yè)務的一些數(shù)據(jù)報表,比如訂單數(shù)量、變化趨勢、用戶數(shù)據(jù)等等,具體結合開放的業(yè)務擬定;
2. 開放平臺內(nèi)管系統(tǒng)
開放平臺內(nèi)管系統(tǒng),主要是解決內(nèi)部商務人員對需求的補充,相關部門負責人對接入需求的審核、系統(tǒng)管理員對參數(shù)配置以及服務管理等,同時也管理相關對接人員制定及運營管理部分的配置和查看等。
接入申請審核&參數(shù)配置:內(nèi)部相關人員對開發(fā)者申請需求進行審批,審批成功后執(zhí)行的人員對參數(shù)進行配置并制定對接人負責后續(xù)接口聯(lián)調(diào)及相關問題解答;
運營管理:主要是對交易類型訂單的管理及對賬,同時管理相關報表數(shù)據(jù)的需求,進行配置;
3. 安全機制
安全機制中主要是對開發(fā)者賬號及權限進行管理,訪問次數(shù)流量監(jiān)控,IP地址管控,黑白名單管控等,其中針對公司人員變動問題,對于訪問服務器地址控制是比較重要的。
四、接口設計
開放平臺的功能基本上說清楚了,還有一個細分部分我們單獨拉出來說一下,就是接口的設計。
通常情況下,開放的相關服務我們自己的系統(tǒng)已經(jīng)進行引用,并且有相應的接口函數(shù),但是不能直接用,因為作為平臺服務方,我們由于版本問題及一些歷史原因等可能存在一些歷史遺留問題,作為開放平臺對外輸出的接口我們應該關注并處理一下幾個方面:
1. 對接口的整合
對于一些比較復雜的無用的字段一定要進行刪除,避免給開發(fā)者造成不必要困擾
2. 對各版本系統(tǒng)兼容性
這個主要針對的是有些廠商,設備前端軟件版本不同,造成參數(shù)內(nèi)容范圍統(tǒng)計不完善的情況,云平臺一定要進行整合兼容。
比如停場場景下,前端停車管理軟件歷史性版本中返給云平臺的車輛狀態(tài)碼有20種,但是云平臺對外開放時只考慮到了10種狀態(tài)碼(或許是本來就只有10種狀態(tài)),而這樣在實際運行中,如果云平臺只是做一個透傳沒有做兼容,那么就有可能第三方系統(tǒng)獲取到了未知狀態(tài)碼(接口文檔上沒有),從而造成第三方開發(fā)者設計的系統(tǒng)存在缺陷。
3. 協(xié)議適配
提供服務的可能是一些老舊的系統(tǒng),報文格式可能是XML、定長報文等,這時就需要對不同協(xié)議的報文進行適配轉化,形成統(tǒng)一
五、開放平臺管理
開放平臺設計好后,還需要進行良好的運營管理,才能發(fā)揮開放平臺應有的用途,同時增強公司的品牌力量及核心競爭力。
首先我們來看一下一個案例,我梳理的一個開放平臺的對接流程圖:
接入對接的各個環(huán)節(jié)流程,基本上就是上面這個流程圖所示,下面主要講解幾個注意事項:
1. 開發(fā)者提交申請后,通常建議是售前或者商務人員進行審核和補充,其中包括客戶的價值、項目價值,費用核算等,因為客戶填寫的需求通常只會設計功能及使用層面。公司前端銷售人員填寫的資料有助于審核通過,公司項目管控肯定是基于銷售情況,比如有訂單的優(yōu)先、高價值客戶優(yōu)先等
2. 審核負責人一般包含兩部分,一個是市場端的負責人審核,便于后期對公司內(nèi)部做結算管理一個是技術支撐端負責人審核,主要是需求明確及工作量和費用
備注:關于審核,前端銷售容易什么需求都接,也不太考慮相關成本,因此平臺公司最好建立良好的成本管控意識及機制,并且在審核時涉及工作量的一定要反饋給前端,不然容易造成什么需求都在接,接了后實際并沒有對公司整體業(yè)務有太大價值,或者技術支撐人員疲于第三方的對接。
3. 配置參數(shù)后,通常可以直接將相關的技術對接人在平臺給到開發(fā)者,相關問題可以直接溝通。當項目啟動后,也可以平臺方前端人員將兩方的相關人員一并拉在一個群里面進行溝通。平臺方技術人員也需要具備客戶意識,盡量尊重和有禮有節(jié)的處理客戶需求。
4. 在測試環(huán)境通過后,開發(fā)者可以發(fā)起正式環(huán)境上線申請,平臺方配置相關參數(shù),開發(fā)者進行生產(chǎn)環(huán)境發(fā)布
5. 發(fā)布后,開發(fā)者的運營及財務就需要介入了,進行數(shù)據(jù)查看及訂單對賬結算等
六、后記
至此呢,基本上就將一個智能硬件廠商的開放平臺的設計和管理總結清楚了,當然本方案其實也適用于一些其他行業(yè)或者系統(tǒng),希望對同行有一點點啟發(fā),同時如有不正確之處,歡迎指正和交流!
2019年回歸物聯(lián)網(wǎng),我們一起成長,春季期間將陸續(xù)整理相關總結及知識進行分析,盡請持續(xù)關注!
作者:Kent,微信公眾號:Liuke2019
本文由 @Kent 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉載
題圖來自Unsplash,基于CC0協(xié)議
目前在做政府端的開放平臺,是否可以交流學習
寫得很好,讓我對開放平臺有了一個整體的認識。
寫的很棒,有很多共性的思路
感謝分享,有學習到。
麻煩咨詢開放平臺的參數(shù)和返回結果,以及釋義的這些維護也是在內(nèi)部管理系統(tǒng)里實現(xiàn)的么,也是有可視化的網(wǎng)站進行操作么
最近在做開放平臺,文章很有借鑒意義,請教一下,做開發(fā)平臺的開發(fā)者門戶、開放者內(nèi)部管理系統(tǒng)、安全機制,這三者先有先后順序么?方便的話,可以weixin詳細請教嗎?
可以加微信互相交流么,最近也在設計開放平臺
我最近也再設計開放平臺
可以交流嗎
爆贊,目前正準備學習和設計保險開放平臺,有幫助,可以私聊學習否
以前就是做保險開放平臺的,有空可以私聊我
我的微信zz17621374354
不錯不錯,剛好需要了解
請問短信平臺能做開放平臺嗎
肯定可以的,對外開放短信能力,比如發(fā)送短信、查看短信記錄(發(fā)送成功/失敗)等等,可參考騰訊的短信平臺。
參數(shù)這塊能詳細一點就好了,這塊不是很懂,估計和后端技術掛勾?
說的非常清晰,還是有一些細節(jié),方便私信交流一下嗎
說的很明白了
服務管理和參數(shù)管理的區(qū)別是什么?
方便私信交流一下嗎?
寫的非常真實貼切 ?? ,最近正好在做開放平臺的產(chǎn)品設計,請問方便私信交流嗎?
liu58liu
請問可以加你微信私聊嗎
講的通俗易懂,贊一個
??
學習了,贊一個!
學習了。講得非常棒。
贊一個,另外想問下測試和正式發(fā)布的賬戶體系時怎么設計的呢
同一個賬號 不同參數(shù)
贊一個~
這么好的,把開放平臺講明白的文章居然沒有人回復?