如何設(shè)計(jì)及管理開放平臺(tái)?軟件平臺(tái)設(shè)計(jì)開發(fā)公司

? ??隨著技術(shù)和合作共享思維的發(fā)展，硅谷率先推出了開放平臺(tái)，比如谷歌開放了map api，將自己的地圖能力進(jìn)行開放；twitter開放了社交api，其他廠商，比如游戲等就可以直接調(diào)用twitter賬戶進(jìn)行登錄，同時(shí)關(guān)聯(lián)好友關(guān)系。隨后中國(guó)也對(duì)外開放地圖、新聞門戶、電子商務(wù)、支付等多個(gè)行業(yè)的核心能力。

? ?我們主要集中在從0到1的設(shè)計(jì)過(guò)程中的開放平臺(tái)。我們需要考慮哪些鏈接、我們需要構(gòu)建的基本功能以及我們?nèi)绾芜M(jìn)行業(yè)務(wù)管理。

? ?一、為何搭建開放平臺(tái)

? ?軟件平臺(tái)設(shè)計(jì)開發(fā)者通過(guò)打開自己的平臺(tái)產(chǎn)品服務(wù)的各種API接口，在開發(fā)應(yīng)用時(shí)，如微博登錄、支付寶支付、微信支付、酒店查詢預(yù)約等，使其他第三方開發(fā)者直接呼叫。

? ?事實(shí)上，一些智能硬件設(shè)備制造商在我的工作經(jīng)驗(yàn)中更多地使用這種方法。它們向合作伙伴和客戶開放了管理設(shè)備的能力，以幫助客戶或合作伙伴在自己的系統(tǒng)中快速集成相應(yīng)的能力。

? ?例如，我在物業(yè)集團(tuán)作為一個(gè)智能社區(qū)工作，涉及智能停車、智能接入、智能安全和智慧，如果我們自己建設(shè)，當(dāng)然很費(fèi)時(shí)，如果我們利用硬件供應(yīng)商的開放平臺(tái)，它可以快速地在我們自己的系統(tǒng)中建立相應(yīng)的能力，作為一個(gè)制造商，他們成功地為我們提供了自己的服務(wù)能力，促進(jìn)了他們的品牌有效性，增強(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)主要是軟件平臺(tái)設(shè)計(jì)開發(fā)人員，以API、H5的形式向第三方合作伙伴或客戶開放自己的資源或服務(wù)，幫助他們快速構(gòu)建自己的應(yīng)用程序。

? ? ? ? ? ? ? ? 從形式上來(lái)說(shuō)，大致分為兩類：

? ?1、當(dāng)開發(fā)者請(qǐng)求時(shí)，開放平臺(tái)返回相應(yīng)的H5鏈接。在這種形式下，開發(fā)者通常會(huì)傳入自己系統(tǒng)的用戶賬號(hào)信息，然后直接在開放平臺(tái)的H5鏈接內(nèi)執(zhí)行服務(wù)。這種開放形式是為支付寶服務(wù)，如社保公積金查詢、汽車服務(wù)等。

優(yōu)點(diǎn)：對(duì)于開發(fā)商來(lái)說(shuō)開發(fā)成本很低，開發(fā)量少，上線時(shí)間快，不需要詳細(xì)了解相應(yīng)業(yè)務(wù)的邏輯和規(guī)則。對(duì)于平臺(tái)來(lái)說(shuō)，與不同的開發(fā)人員接口更簡(jiǎn)單。

缺點(diǎn)：開發(fā)人員無(wú)法直接獲取本系統(tǒng)用戶的實(shí)際業(yè)務(wù)情況，與以下單筆交易量、訂單量等相比，完全依賴于平臺(tái)提供的數(shù)據(jù)；相應(yīng)頁(yè)面的風(fēng)格無(wú)法改變，可能存在不符合自身制度風(fēng)格的風(fēng)險(xiǎn)；

2、開發(fā)人員請(qǐng)求時(shí)，根據(jù)API的功能傳入相應(yīng)的參數(shù)，平臺(tái)返回相應(yīng)的數(shù)據(jù)內(nèi)容，內(nèi)容集成后，開發(fā)人員再按照樣式執(zhí)行演示..

優(yōu)點(diǎn)：對(duì)于具有交易類型和共享的業(yè)務(wù)，開發(fā)人員可以自己掌握相關(guān)的訂單數(shù)據(jù)，而不受平臺(tái)提供的數(shù)據(jù)的限制。

缺點(diǎn)：開發(fā)成本相對(duì)較高，開發(fā)人員需要詳細(xì)了解業(yè)務(wù)規(guī)則和邏輯，同時(shí)要進(jìn)行前端頁(yè)面的設(shè)計(jì)和開發(fā)。平臺(tái)技術(shù)方面需要連接開發(fā)人員的界面并對(duì)問(wèn)題進(jìn)行解釋，這對(duì)于人力資源投資來(lái)說(shuō)是相對(duì)較高的。

總的來(lái)說(shuō)，不一定是哪種形式更好。我們需要結(jié)合實(shí)際情況來(lái)決定哪種形式的開放平臺(tái)是開放的。合作關(guān)系、業(yè)務(wù)模式、團(tuán)隊(duì)情況、業(yè)務(wù)發(fā)展階段、系統(tǒng)穩(wěn)定性等都是需要考慮的因素。最后，詳細(xì)提出了采用何種或多種形式；

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

這一次，我們主要討論的是屬于企業(yè)服務(wù)類型的API模式開放平臺(tái)的設(shè)計(jì)與開發(fā)。主要要求符合智能硬件制造商開放式平臺(tái)的設(shè)計(jì)要求。支付寶和微信類型的標(biāo)準(zhǔn)訪問(wèn)類型開放平臺(tái)是有區(qū)別的。產(chǎn)品需求主要來(lái)自分析的水平，從需求到功能擴(kuò)展，不涉及具體的技術(shù)方面。

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

1.開發(fā)者身份注冊(cè)與數(shù)據(jù)權(quán)限范圍授權(quán)

2.開發(fā)人員獲取相關(guān)信息（接口文檔、使用說(shuō)明、對(duì)接聯(lián)系人信息等）。

3.平臺(tái)端內(nèi)部管理、應(yīng)用審核流程、服務(wù)、業(yè)務(wù)交易管理、參數(shù)、人員等業(yè)務(wù)流程參數(shù)配置。

4.商業(yè)交易管理和統(tǒng)計(jì)報(bào)告分析（涉及雙方要求的結(jié)算類型）。

5.安全級(jí)別需求、加密、應(yīng)用密鑰、應(yīng)用接口權(quán)限控制、對(duì)黑白名單的訪問(wèn)、現(xiàn)場(chǎng)減敏、恢復(fù)等。

結(jié)合需求分析，對(duì)開放平臺(tái)的基本功能進(jìn)行了排序，主要針對(duì)開發(fā)人員、內(nèi)部管理員以及基于安全級(jí)別的一些功能要求。

? ? ? ? 1. 開發(fā)者門戶

? ? ? ? ?通常，開放平臺(tái)會(huì)掛在公司官方網(wǎng)站的某個(gè)入口，當(dāng)然，有時(shí)也會(huì)放在特定的門戶網(wǎng)站地址。開發(fā)人員門戶主要是幫助用戶在平臺(tái)注冊(cè)、申請(qǐng)?jiān)L問(wèn)、查詢和查看進(jìn)度、查看相關(guān)訪問(wèn)參數(shù)、下載文件等。訪問(wèn)成功后，在線查看一些操作數(shù)據(jù)，便于與平臺(tái)方進(jìn)行協(xié)調(diào)。

注冊(cè)接入申請(qǐng)：開發(fā)者可以通過(guò)公司名稱、手機(jī)號(hào)碼或電子郵件地址注冊(cè)賬號(hào)，注冊(cè)后填寫接入申請(qǐng)。申請(qǐng)表一般包括準(zhǔn)入需求說(shuō)明、關(guān)聯(lián)項(xiàng)目、聯(lián)系人（平臺(tái)方、一般業(yè)務(wù)人員）、申請(qǐng)人聯(lián)系人及聯(lián)系方式、準(zhǔn)入方式、費(fèi)用、申請(qǐng)類型等；

注：收費(fèi)問(wèn)題必須明確說(shuō)明，一些合作伙伴需要定制開發(fā)，通常收費(fèi)，一般標(biāo)準(zhǔn)API訪問(wèn)免費(fèi)，定制系統(tǒng)開發(fā)需要收費(fèi)（一些合作伙伴會(huì)有開發(fā)要求）；

進(jìn)度視圖及參數(shù)獲?。禾峤簧暾?qǐng)后，開發(fā)者可以在線查看申請(qǐng)進(jìn)度。審批成功后，開發(fā)人員可以查看相關(guān)的訪問(wèn)參數(shù)。如果審批不成功，開發(fā)商可以修改并重新提交；

下載相關(guān)文件：開發(fā)人員可以將接口下載到自己的文件和其他相關(guān)文件;

業(yè)務(wù)往來(lái)管理：針對(duì)不同開放業(yè)務(wù)涉及的不同內(nèi)容，對(duì)于有訂單業(yè)務(wù)或支付服務(wù)的業(yè)務(wù)，需要進(jìn)行往來(lái)管理，主要包括業(yè)務(wù)查看、對(duì)賬、結(jié)算等基本功能；

統(tǒng)計(jì)報(bào)表：主要根據(jù)開發(fā)商的業(yè)務(wù)類型，提供一些相關(guān)服務(wù)的數(shù)據(jù)報(bào)表，如訂單數(shù)量、變化趨勢(shì)、用戶數(shù)據(jù)等，并與開放業(yè)務(wù)發(fā)展相結(jié)合；

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

開放平臺(tái)內(nèi)部管理系統(tǒng)主要解決內(nèi)部業(yè)務(wù)人員的需求、相關(guān)部門負(fù)責(zé)人對(duì)訪問(wèn)需求的審核、系統(tǒng)管理員對(duì)參數(shù)配置和服務(wù)管理等問(wèn)題，以及相關(guān)對(duì)接人員的配置和視圖開發(fā)和運(yùn)行管理。

接入申請(qǐng)審核和參數(shù)配置：內(nèi)部相關(guān)人員審批開發(fā)者的應(yīng)用要求，審批成功后執(zhí)行的人員應(yīng)配置參數(shù)，并制定接口人的聯(lián)合調(diào)試及相關(guān)問(wèn)題。

操作管理：主要用于交易類型訂單的管理與對(duì)賬，以及相關(guān)報(bào)表數(shù)據(jù)的管理要求與配置；

3. 安全機(jī)制

安全機(jī)制主要管理開發(fā)人員的帳戶和權(quán)限、訪問(wèn)次數(shù)、IP地址的控制、黑白列表的控制等。并且重要的是控制訪問(wèn)服務(wù)器的地址以改變公司的人員。

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

開放平臺(tái)功能基本明確。另外還有一個(gè)細(xì)分，我們會(huì)分別拉出來(lái)，就是界面的設(shè)計(jì)。

一般情況下，開放相關(guān)服務(wù)已由自己的系統(tǒng)引用，具有相應(yīng)的接口功能，但不能直接使用，因?yàn)樽鳛檐浖脚_(tái)設(shè)計(jì)和開發(fā)服務(wù)，由于版本問(wèn)題和一些歷史原因，我們可能有一些歷史遺留問(wèn)題。作為開放平臺(tái)外部輸出的接口，我們應(yīng)注意和處理幾個(gè)方面：

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

對(duì)于一些復(fù)雜無(wú)用的字段，必須刪除，以免給開發(fā)人員帶來(lái)不必要的麻煩

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

主要目標(biāo)是一些廠商和設(shè)備前端軟件版本不同，因此參數(shù)內(nèi)容范圍統(tǒng)計(jì)不完美，云平臺(tái)必須完全兼容。

例如，在停車場(chǎng)景中，前端停車管理軟件的歷史版本中返回云平臺(tái)的車輛狀態(tài)碼有20個(gè)，但云平臺(tái)對(duì)外開放時(shí)只考慮10個(gè)狀態(tài)碼（可能原來(lái)只有10個(gè)狀態(tài)）。在實(shí)際操作中，如果云平臺(tái)只是做一個(gè)透明的傳輸而不兼容，那么第三方系統(tǒng)可能獲得未知的狀態(tài)碼（不在接口文檔上），從而導(dǎo)致第三方開發(fā)者設(shè)計(jì)的系統(tǒng)出現(xiàn)缺陷。

3. 協(xié)議適配

服務(wù)可以是舊系統(tǒng)，消息格式可以是XML、固定長(zhǎng)度消息等。在這種情況下，有必要修改和變換不同協(xié)議的消息，以形成統(tǒng)一的協(xié)議。

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

開放平臺(tái)的設(shè)計(jì)開發(fā)完成后，需要良好的運(yùn)營(yíng)管理，才能充分發(fā)揮開放平臺(tái)的應(yīng)有作用，提升公司的品牌實(shí)力和核心競(jìng)爭(zhēng)力。

首先，讓我們看看一個(gè)案例，在這個(gè)案例中我將梳理一個(gè)開放平臺(tái)的對(duì)接流程圖：

? ? ? ? 進(jìn)出對(duì)接各環(huán)節(jié)的流程基本如上圖所示。以下主要介紹以下注意事項(xiàng)：

1、開發(fā)人員提交申請(qǐng)后，通常建議由售前或業(yè)務(wù)人員進(jìn)行審核和補(bǔ)充，包括客戶價(jià)值、項(xiàng)目?jī)r(jià)值、成本核算等，因?yàn)榭蛻籼顚懙囊笸ǔＶ辉诠δ芎褪褂眉?jí)別上設(shè)計(jì)。公司前端銷售人員填寫的信息有助于審批。公司的項(xiàng)目管理和控制必須以銷售情況為基礎(chǔ)，如訂單優(yōu)先、高價(jià)值客戶優(yōu)先等

2、審計(jì)負(fù)責(zé)人一般由兩部分組成，一是對(duì)市場(chǎng)側(cè)負(fù)責(zé)的人進(jìn)行審計(jì)，便于后期在公司內(nèi)部進(jìn)行結(jié)算管理，二是對(duì)技術(shù)支持方負(fù)責(zé)人的審計(jì)，主要原因是要求明確，工作量大，費(fèi)用高。

注：在審核方面，前端銷售很容易滿足任何需求，也不太考慮相關(guān)成本。因此，平臺(tái)公司最好建立一個(gè)良好的成本控制意識(shí)和機(jī)制，而審計(jì)所涉及的工作量必須反饋到前端，否則很容易造成任何需求都得滿足。審計(jì)后，對(duì)公司整體業(yè)務(wù)或技術(shù)支持價(jià)值不大的人都厭倦了第三方對(duì)接。

3、在配置參數(shù)后，通?？梢詫⑾嚓P(guān)技術(shù)直接連接到平臺(tái)上的開發(fā)人員，并對(duì)相關(guān)問(wèn)題進(jìn)行直接溝通。項(xiàng)目啟動(dòng)時(shí)，平臺(tái)前端人員還可以將雙方相關(guān)人員拉到一起，進(jìn)行分組溝通。平臺(tái)側(cè)技術(shù)人員也需要有客戶的意識(shí)，尊重和滿足客戶的需要盡可能多。

4，通過(guò)測(cè)試環(huán)境，開發(fā)者可以開始正式的環(huán)境在線應(yīng)用，平臺(tái)端的配置參數(shù)，發(fā)布生產(chǎn)環(huán)境中的開發(fā)人員

5、發(fā)布后，開發(fā)商的運(yùn)營(yíng)和財(cái)務(wù)需要參與數(shù)據(jù)審核、訂單對(duì)賬和結(jié)算等

6、后記

在這一點(diǎn)上，我基本上總結(jié)了一個(gè)面向智能硬件制造商的開放平臺(tái)的設(shè)計(jì)、開發(fā)和管理。當(dāng)然，這個(gè)方案也適用于其他一些行業(yè)或系統(tǒng)。希望能給同齡人一些啟發(fā)。如果有任何錯(cuò)誤，請(qǐng)改正和溝通！