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

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

? ?一、為何搭建開放平臺

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

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

? ?例如，我在物業(yè)集團作為一個智能社區(qū)工作，涉及智能停車、智能接入、智能安全和智慧，如果我們自己建設(shè)，當(dāng)然很費時，如果我們利用硬件供應(yīng)商的開放平臺，它可以快速地在我們自己的系統(tǒng)中建立相應(yīng)的能力，作為一個制造商，他們成功地為我們提供了自己的服務(wù)能力，促進了他們的品牌有效性，增強了產(chǎn)品的競爭力。

? ? 注意：在某些情況下，H5也可以向第三方開放。在這種情況下，第三方不需要進行頁面和后臺開發(fā)，只需要根據(jù)平臺方的要求傳入相應(yīng)的參數(shù)。

? ??二、開放平臺服務(wù)形式

? ? 開放平臺主要是軟件平臺設(shè)計開發(fā)人員，以API、H5的形式向第三方合作伙伴或客戶開放自己的資源或服務(wù)，幫助他們快速構(gòu)建自己的應(yīng)用程序。

? ? ? ? ? ? ? ? 從形式上來說，大致分為兩類：

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

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

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

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

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

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

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

三、開放平臺設(shè)計

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

開放平臺主要解決以下幾個層面的需求：

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

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

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

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

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

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

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

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

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

注：收費問題必須明確說明，一些合作伙伴需要定制開發(fā)，通常收費，一般標準API訪問免費，定制系統(tǒng)開發(fā)需要收費（一些合作伙伴會有開發(fā)要求）；

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

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

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

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

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

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

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

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

3. 安全機制

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

四、接口設(shè)計

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

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

1. 對接口的整合

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

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

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

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

3. 協(xié)議適配

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

五、開放平臺管理

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

首先，讓我們看看一個案例，在這個案例中我將梳理一個開放平臺的對接流程圖：

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

1、開發(fā)人員提交申請后，通常建議由售前或業(yè)務(wù)人員進行審核和補充，包括客戶價值、項目價值、成本核算等，因為客戶填寫的要求通常只在功能和使用級別上設(shè)計。公司前端銷售人員填寫的信息有助于審批。公司的項目管理和控制必須以銷售情況為基礎(chǔ)，如訂單優(yōu)先、高價值客戶優(yōu)先等

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

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

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

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

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

6、后記

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