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