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

如何設(shè)計(jì)及管理開放平臺？本篇文章介紹了在從0到1設(shè)計(jì)過程中，需要考慮哪些環(huán)節(jié)，搭建哪些基礎(chǔ)功能，以及如何進(jìn)行運(yùn)營管理。隨著技術(shù)和合作共享思維的發(fā)展，硅谷率先推出了開放平臺，比如谷歌開放了mapapi，將自己的地圖能力進(jìn)行開放。twitter開放了社交api，其他廠商，比如游戲等就可以直接調(diào)用twitter賬戶進(jìn)行登錄，同時關(guān)聯(lián)好友關(guān)系。國內(nèi)隨后也掀起了一場開放浪潮，逐漸開放了地圖、新聞門戶、電商、支付等很多行業(yè)的核心能力。本次我們主要集中聊一聊一個開放平臺在從0到1設(shè)計(jì)過程中，我們需要考慮哪些環(huán)節(jié)，我們需要搭建哪些基礎(chǔ)功能，以及我們?nèi)绾芜M(jìn)行運(yùn)營管理。一、為什么要搭建開放平臺？通過開放自己平臺產(chǎn)品服務(wù)的各種API接口，讓其他第三方開發(fā)者在開發(fā)應(yīng)用時根據(jù)需求直接調(diào)用，例如微博登錄、支付寶支付，微信支付、酒店查詢預(yù)訂等等。此種方式在我從業(yè)經(jīng)驗(yàn)中用的較多的其實(shí)是一些智能硬件設(shè)備廠商，將管理設(shè)備的能力開放給合作伙伴和客戶，幫助客戶或者合作伙伴能夠快速在自己系統(tǒng)中集成相應(yīng)的能力。比如之前我在物業(yè)集團(tuán)做智慧社區(qū)，涉及到智慧停車、智慧門禁、智慧安防、智慧對講，如果我們一個一個自己搭建，當(dāng)然是費(fèi)力費(fèi)事，如果我們借助于硬件廠商的開放平臺，就可以快速在我們自己的系統(tǒng)搭建起相應(yīng)能力，作為廠商來說，他們就成功將自己的服務(wù)能力提供給了我們，提升了他們的品牌效力，同時加強(qiáng)了產(chǎn)品競爭力。備注：部分情況下，也可以開放H5給第三方，此種情況下第三方不需要再進(jìn)行頁面和后臺開發(fā)，只需要根據(jù)平臺方要求傳入相應(yīng)的參數(shù)即可。二、開放平臺服務(wù)形式開放平臺主要是將自己的資源或者服務(wù)通過API、H5的形式開放給第三方合作伙伴或者客戶進(jìn)行對接，幫助他們快速構(gòu)建自己的某一項(xiàng)應(yīng)用。從形式上來說，大致分為兩類：1.開發(fā)者請求時，開放平臺返回對應(yīng)的H5鏈接，在這種形式下，通常是開發(fā)者傳入自己系統(tǒng)的用戶賬戶信息，然后直接在開放平臺的H5鏈接內(nèi)進(jìn)行服務(wù)。這種形式的開放在支付寶的服務(wù)中就有很多，比如社保公積金查詢、汽車服務(wù)等。優(yōu)勢：對于開發(fā)者來說，開發(fā)成本極低，基本上沒有什么開發(fā)量，上線時間更快，且無需詳細(xì)了解對應(yīng)業(yè)務(wù)的邏輯及規(guī)則等。對于平臺方來說，也更簡單，不用重復(fù)和不同的開發(fā)者進(jìn)行接口聯(lián)調(diào)。劣勢：開發(fā)者無法直接獲取自己系統(tǒng)用戶實(shí)際的業(yè)務(wù)情況，比如下單量、下單金額等，完全依靠平臺提供的數(shù)據(jù)；相應(yīng)的頁面的風(fēng)格無法變更，可能存在不符合自身系統(tǒng)風(fēng)格風(fēng)險；2.開發(fā)者請求時，根據(jù)API的函數(shù)傳入對應(yīng)的參數(shù)，平臺返回對應(yīng)的數(shù)據(jù)內(nèi)容，開發(fā)者再將內(nèi)容進(jìn)行整合后按照自己的風(fēng)格進(jìn)行呈現(xiàn)。優(yōu)勢：開發(fā)者可以按照自己系統(tǒng)的設(shè)計(jì)規(guī)范進(jìn)行呈現(xiàn)，使用戶無法感知相關(guān)的資源和服務(wù)是第三方平臺提供的。對于有交易類型及分成的業(yè)務(wù)，開發(fā)者可以自己掌握相關(guān)訂單數(shù)據(jù)，不用完全受制于平臺方提供的數(shù)據(jù)；劣勢：開發(fā)成本相對較高，開發(fā)者需要詳細(xì)了解業(yè)務(wù)規(guī)則及邏輯，同時還要進(jìn)行前端頁面設(shè)計(jì)和開發(fā)；平臺技術(shù)方，需要對接開發(fā)者的接口聯(lián)調(diào)及問題解釋，對于人力資源的投入相對來說更高；綜合起來看，也不一定能說哪種形式更好，具體的需要結(jié)合實(shí)際情況來定自己的開放平臺采用哪些形式進(jìn)行開放。合作關(guān)系、業(yè)務(wù)模式、團(tuán)隊(duì)情況、業(yè)務(wù)發(fā)展階段、系統(tǒng)穩(wěn)定性等都是考慮的因素，最后詳細(xì)擬定采用哪種或者多種形式；三、開放平臺設(shè)計(jì)本次我們主要說一說API方式的開放平臺設(shè)計(jì)，其中屬于企業(yè)服務(wù)類型的，主要需求符合智能硬件廠商開放平臺的設(shè)計(jì)需求，與支付寶、微信類型的標(biāo)準(zhǔn)接入型開放平臺有差異。主要從產(chǎn)品需求層面進(jìn)行剖析，從需求引申到功能，不涉及具體技術(shù)層面。開放平臺主要解決以下幾個層面的需求：開發(fā)者身份注冊與數(shù)據(jù)權(quán)限范圍授權(quán)開發(fā)者獲取相關(guān)資料（接口文檔、使用說明、對接人聯(lián)系方式等）平臺方內(nèi)部管理，申請審核流程、服務(wù)配置、業(yè)務(wù)交易管理、參數(shù)配置、人員分配等業(yè)務(wù)交易管理及統(tǒng)計(jì)報表分析（涉及雙方需要結(jié)算的類型）安全層面需求，加密、應(yīng)用秘鑰、應(yīng)用接口權(quán)限控制、訪問黑白名單、字段脫敏還原等結(jié)合針對需求的分析，我們整理了一下開放平臺的基礎(chǔ)功能的清單，主要是針對開發(fā)者、內(nèi)部管理員的，其次是基于安全層面的一些功能需求。1.開發(fā)者門戶通常情況下，開放平臺會掛在公司的官網(wǎng)上某個入口，當(dāng)然有些時候也會放在一個特定的門戶地址。開發(fā)者門戶主要是幫助用戶在平臺進(jìn)行注冊、申請接入、查詢審核進(jìn)度、查看相關(guān)接入?yún)?shù)、下載文檔等，接入成功并上線后，查看一些運(yùn)營數(shù)據(jù)，方便與平臺方進(jìn)行對賬。注冊&接入申請：開發(fā)者通過公司名稱、手機(jī)號或者郵箱進(jìn)行賬號注冊，注冊后即可以填寫接入申請，申請單內(nèi)容一般主要包含接入需求描述、關(guān)聯(lián)項(xiàng)目、聯(lián)系人（平臺方，一般是商務(wù)人員）、申請方聯(lián)系人及聯(lián)系方式、接入模式、費(fèi)用、申請類型等等；備注：關(guān)于費(fèi)用問題一定要描述清楚，有些合作伙伴需要定制開發(fā)，通常是需要收費(fèi)的，一般是標(biāo)準(zhǔn)API接入免費(fèi)，定制化需求及定制化系統(tǒng)開發(fā)需要收取費(fèi)用（有些合作伙伴會有開發(fā)需求）；進(jìn)度查看&參數(shù)獲?。荷暾?zhí)峤缓?，開發(fā)者可以在線查看申請進(jìn)度，審核成功后即可查看相關(guān)接入?yún)?shù)，如果審核不成功可以重新修改后提交；下載相關(guān)文檔：開發(fā)者可以自助下載相關(guān)接口文檔及其他說明文檔；業(yè)務(wù)交易管理：針對開放的業(yè)務(wù)不同涉及的內(nèi)容不同，對于有訂單業(yè)務(wù)或者付費(fèi)服務(wù)的業(yè)務(wù)來說，需要進(jìn)行交易管理，主要是查看交易、對賬、結(jié)算等基礎(chǔ)功能；統(tǒng)計(jì)報表：主要是根據(jù)開發(fā)者的業(yè)務(wù)類型，提供相關(guān)業(yè)務(wù)的一些數(shù)據(jù)報表，比如訂單數(shù)量、變化趨勢、用戶數(shù)據(jù)等等，具體結(jié)合開放的業(yè)務(wù)擬定；2.開放平臺內(nèi)管系統(tǒng)開放平臺內(nèi)管系統(tǒng)，主要是解決內(nèi)部商務(wù)人員對需求的補(bǔ)充，相關(guān)部門負(fù)責(zé)人對接入需求的審核、系統(tǒng)管理員對參數(shù)配置以及服務(wù)管理等，同時也管理相關(guān)對接人員制定及運(yùn)營管理部分的配置和查看等。接入申請審核&參數(shù)配置：內(nèi)部相關(guān)人員對開發(fā)者申請需求進(jìn)行審批，審批成功后執(zhí)行的人員對參數(shù)進(jìn)行配置并制定對接人負(fù)責(zé)后續(xù)接口聯(lián)調(diào)及相關(guān)問題解答；運(yùn)營管理：主要是對交易類型訂單的管理及對賬，同時管理相關(guān)報表數(shù)據(jù)的需求，進(jìn)行配置；3.安全機(jī)制安全機(jī)制中主要是對開發(fā)者賬號及權(quán)限進(jìn)行管理，訪問次數(shù)流量監(jiān)控，IP地址管控，黑白名單管控等，其中針對公司人員變動問題，對于訪問服務(wù)器地址控制是比較重要的。四、接口設(shè)計(jì)開放平臺的功能基本上說清楚了，還有一個細(xì)分部分我們單獨(dú)拉出來說一下，就是接口的設(shè)計(jì)。通常情況下，開放的相關(guān)服務(wù)我們自己的系統(tǒng)已經(jīng)進(jìn)行引用，并且有相應(yīng)的接口函數(shù)，但是不能直接用，因?yàn)樽鳛槠脚_服務(wù)方，我們由于版本問題及一些歷史原因等可能存在一些歷史遺留問題，作為開放平臺對外輸出的接口我們應(yīng)該關(guān)注并處理一下幾個方面：1.對接口的整合對于一些比較復(fù)雜的無用的字段一定要進(jìn)行刪除，避免給開發(fā)者造成不必要困擾2.對各版本系統(tǒng)兼容性這個主要針對的是有些廠商，設(shè)備前端軟件版本不同，造成參數(shù)內(nèi)容范圍統(tǒng)計(jì)不完善的情況，云平臺一定要進(jìn)行整合兼容。比如停場場景下，前端停車管理軟件歷史性版本中返給云平臺的車輛狀態(tài)碼有20種，但是云平臺對外開放時只考慮到了10種狀態(tài)碼（或許是本來就只有10種狀態(tài)），而這樣在實(shí)際運(yùn)行中，如果云平臺只是做一個透傳沒有做兼容，那么就有可能第三方系統(tǒng)獲取到了未知狀態(tài)碼（接口文檔上沒有），從而造成第三方開發(fā)者設(shè)計(jì)的系統(tǒng)存在缺陷。3.協(xié)議適配提供服務(wù)的可能是一些老舊的系統(tǒng)，報文格式可能是XML、定長報文等，這時就需要對不同協(xié)議的報文進(jìn)行適配轉(zhuǎn)化，形成統(tǒng)一五、開放平臺管理開放平臺設(shè)計(jì)好后，還需要進(jìn)行良好的運(yùn)營管理，才能發(fā)揮開放平臺應(yīng)有的用途，同時增強(qiáng)公司的品牌力量及核心競爭力。首先我們來看一下一個案例，我梳理的一個開放平臺的對接流程圖：接入對接的各個環(huán)節(jié)流程，基本上就是上面這個流程圖所示，下面主要講解幾個注意事項(xiàng)：1.開發(fā)者提交申請后，通常建議是售前或者商務(wù)人員進(jìn)行審核和補(bǔ)充，其中包括客戶的價值、項(xiàng)目價值，費(fèi)用核算等，因?yàn)榭蛻籼顚懙男枨笸ǔＶ粫O(shè)計(jì)功能及使用層面。公司前端銷售人員填寫的資料有助于審核通過，公司項(xiàng)目管控肯定是基于銷售情況，比如有訂單的優(yōu)先、高價值客戶優(yōu)先等2.審核負(fù)責(zé)人一般包含兩部分，一個是市場端的負(fù)責(zé)人審核，便于后期對公司內(nèi)部做結(jié)算管理一個是技術(shù)支撐端負(fù)責(zé)人審核，主要是需求明確及工作量和費(fèi)用備注：關(guān)于審核，前端銷售容易什么需求都接，也不太考慮相關(guān)成本，因此平臺公司最好建立良好的成本管控意識及機(jī)制，并且在審核時涉及工作量的一定要反饋給前端，不然容易造成什么需求都在接，接了后實(shí)際并沒有對公司整體業(yè)務(wù)有太大價值，或者技術(shù)支撐人員疲于第三方的對接。3.配置參數(shù)后，通?？梢灾苯訉⑾嚓P(guān)的技術(shù)對接人在平臺給到開發(fā)者，相關(guān)問題可以直接溝通。當(dāng)項(xiàng)目啟動后，也可以平臺方前端人員將兩方的相關(guān)人員一并拉在一個群里面進(jìn)行溝通。平臺方技術(shù)人員也需要具備客戶意識，盡量尊重和有禮有節(jié)的處理客戶需求。4.在測試環(huán)境通過后，開發(fā)者可以發(fā)起正式環(huán)境上線申請，平臺