基于接入機(jī)智云設(shè)備數(shù)據(jù)開(kāi)展企業(yè)某個(gè)垂直領(lǐng)域業(yè)務(wù)需求

企業(yè)應(yīng)用是企業(yè)將設(shè)備接入云平臺(tái)后，企業(yè)需要獲取設(shè)備數(shù)據(jù)用于實(shí)現(xiàn)企業(yè)特定的業(yè)務(wù)管理功能，以實(shí)現(xiàn)企業(yè)對(duì)設(shè)備、設(shè)備消費(fèi)者的運(yùn)營(yíng)管理需要。企業(yè)應(yīng)用在開(kāi)發(fā)過(guò)程中，通過(guò)機(jī)智云物聯(lián)網(wǎng)平臺(tái)的 SNoti 服務(wù)功能即可獲取接入設(shè)備的數(shù)據(jù)，同時(shí)基于企業(yè) API 實(shí)現(xiàn)控制設(shè)備、進(jìn)行設(shè)備數(shù)據(jù)的統(tǒng)計(jì)分析，讓企業(yè)集中精力關(guān)注企業(yè)應(yīng)用的整體業(yè)務(wù)。

01 SNoti 服務(wù)功能

SNoti 服務(wù)是一個(gè)實(shí)時(shí)設(shè)備消息傳輸服務(wù)，該服務(wù)可以實(shí)時(shí)將企業(yè)的設(shè)備數(shù)據(jù)推送到企業(yè)應(yīng)用系統(tǒng)，企業(yè)應(yīng)用系統(tǒng)基于設(shè)備數(shù)據(jù)實(shí)現(xiàn)業(yè)務(wù)需求。

注意：使用 SNoti 服務(wù)之前，要先開(kāi)通 SNoti 服務(wù)和添加白名單。

SNoti 服務(wù)的能力包括：

◆ 基于消息發(fā)布/訂閱模型；

◆ 設(shè)備數(shù)據(jù)傳輸平均時(shí)長(zhǎng)40-50ms；

◆ 支持多客戶端同時(shí)請(qǐng)求；

◆ 支持 SSL 傳輸；

◆ 設(shè)備消息默認(rèn)緩存3天，并可按企業(yè)需求定制；

◆ 提供設(shè)備消息的監(jiān)控預(yù)警。

02 企業(yè) OPEN API

企業(yè) OPEN API 是機(jī)智云為接入機(jī)智云平臺(tái)的企業(yè)開(kāi)發(fā)者提供的開(kāi)放 API 服務(wù)，使用企業(yè) API 的企業(yè)將設(shè)備接入到機(jī)智云平臺(tái)后，通常還有進(jìn)一步基于接入機(jī)智云設(shè)備數(shù)據(jù)開(kāi)展企業(yè)某個(gè)垂直領(lǐng)域的業(yè)務(wù)需求。

企業(yè) API 為企業(yè)提供企業(yè)視角全局的設(shè)備管理、數(shù)據(jù)分析等功能，讓企業(yè)更關(guān)注業(yè)務(wù)管理系統(tǒng)本身，減少不必要的開(kāi)發(fā)成本。

注意：注冊(cè)開(kāi)發(fā)者中心的企業(yè)用戶是默認(rèn)開(kāi)通企業(yè) API 。

03案例介紹說(shuō)明

充電樁 SaaS 平臺(tái)

充電樁 SaaS 平臺(tái)是充電樁運(yùn)營(yíng)商為電動(dòng)車主提供了尋找電樁、預(yù)約、充電、支付等功能，運(yùn)營(yíng)商通過(guò)運(yùn)營(yíng)管理平臺(tái)對(duì)充電樁、故障、訂單、計(jì)費(fèi)規(guī)則、訂單管理、結(jié)算等管理功能。充電樁運(yùn)營(yíng)商通過(guò)充電樁 SaaS 平臺(tái)可以完整閉環(huán)的管理日常業(yè)務(wù)，大大提高運(yùn)營(yíng)效率。

充電樁設(shè)備接入了機(jī)智云，充電樁 SaaS 平臺(tái)需要實(shí)時(shí)獲得充電樁的數(shù)據(jù)，根據(jù)這些數(shù)據(jù)才能計(jì)算充電費(fèi)用，是否有故障等。

這些設(shè)備數(shù)據(jù)正是由機(jī)智云 PaaS 平臺(tái)負(fù)責(zé)采集，并通過(guò) SNoti 服務(wù)實(shí)時(shí)推送給充電樁 SaaS 平臺(tái)。充電樁 SaaS 平臺(tái)還可以通過(guò)企業(yè) API 開(kāi)放的接口進(jìn)行統(tǒng)計(jì)分析，如設(shè)備的位置服務(wù)查詢，設(shè)備通信數(shù)據(jù)查詢，充電樁故障數(shù)查詢等功能。

分時(shí)租賃系統(tǒng)

分時(shí)租賃平臺(tái)的業(yè)務(wù)其實(shí)與充電樁 SaaS 平臺(tái)類似，對(duì)于分時(shí)租賃的運(yùn)營(yíng)管理方，如運(yùn)營(yíng)汽車租賃、自行車租賃的企業(yè)。這些企業(yè)需要建設(shè)一套分時(shí)租賃管理平臺(tái)，實(shí)現(xiàn)訂單、結(jié)算、支付等必要功能。

汽車、自行車接入到機(jī)智云物聯(lián)網(wǎng)平臺(tái)，企業(yè)就無(wú)需在設(shè)備的物聯(lián)接入進(jìn)行投入，企業(yè)只需通過(guò)接入?yún)f(xié)議接入 SNoti 服務(wù)即可獲取設(shè)備數(shù)據(jù)進(jìn)行業(yè)務(wù)開(kāi)發(fā)。

04 開(kāi)發(fā)流程介紹

SNoti 服務(wù)接入

1、提出申請(qǐng)

步驟①：企業(yè)開(kāi)發(fā)者登陸新版開(kāi)發(fā)者中心

https://developer.gizwits.com/#/login

點(diǎn)擊右上角【賬號(hào)】-【企業(yè)信息】-【服務(wù)中心】，如下圖。

步驟②：選擇左側(cè)組織，再點(diǎn)擊【數(shù)據(jù)推送服務(wù)】，點(diǎn)擊【立即開(kāi)通】，申請(qǐng)開(kāi)通后等待審核。

步驟③：待審核通過(guò)后，點(diǎn)擊【返回舊版】，需返回舊版開(kāi)發(fā)者中心使用此功能。（由于新版功能還在開(kāi)發(fā)完善中，部分功能仍會(huì)在舊版使用中）。

2、獲取參數(shù)

選擇產(chǎn)品，然后再點(diǎn)擊【SNoti 服務(wù)】，點(diǎn)擊“新建授權(quán)”創(chuàng)建，該 auth_id 擁有獲取該產(chǎn)品下所有設(shè)備消息和控制設(shè)備的權(quán)限；

3、理解協(xié)議

具體協(xié)議見(jiàn)：

http://docs.gizwits.com/zh-cn/Cloud/NotificationAPI.html

4、按需實(shí)現(xiàn)客戶端

企業(yè)根據(jù) Demo Code ，根據(jù)自己的需求實(shí)現(xiàn)客戶端功能開(kāi)發(fā)，可以以 Demo Code 為原型，實(shí)現(xiàn)接收到設(shè)備數(shù)據(jù)后的業(yè)務(wù)邏輯。如：

◆ 解析 SNoti 服務(wù)推送的 JSON 報(bào)文

◆ 實(shí)時(shí)將獲取的消息 Publish 到企業(yè)應(yīng)用所屬的隊(duì)列中，進(jìn)行異步操作；

◆ 也可以直接解析后，將數(shù)據(jù)寫入數(shù)據(jù)庫(kù)，但需要建立數(shù)據(jù)的定期清理策略。

5、通過(guò)虛擬設(shè)備模擬真實(shí)設(shè)備推送數(shù)據(jù)

企業(yè)如果還沒(méi)有真實(shí)設(shè)備接入到機(jī)智云，可以使用虛擬設(shè)備模擬一遍。

◆ 啟動(dòng) Demo Code，前提是已修改為正確的 product_key，auth_id與auth_secret；

◆ 在該產(chǎn)品下并定義了數(shù)據(jù)點(diǎn)；

◆ 審批通過(guò)后即可啟動(dòng)虛擬設(shè)備，并模擬數(shù)據(jù)，點(diǎn)擊”推送“；

◆ Demo Code會(huì)實(shí)時(shí)打印SNoti服務(wù)推送的設(shè)備狀態(tài)數(shù)據(jù)。

使用企業(yè) API1、默認(rèn)開(kāi)通企業(yè)API服務(wù)企業(yè)開(kāi)發(fā)者登錄新版開(kāi)發(fā)者中心，注冊(cè)開(kāi)發(fā)者中心的企業(yè)用戶默認(rèn)開(kāi)通企業(yè)API。

https://developer.gizwits.com/#/login

可查看已開(kāi)通的服務(wù)，如下圖。

2、獲取參數(shù)

登陸新版開(kāi)發(fā)者中心，點(diǎn)擊右上角的【賬號(hào)】，選擇【企業(yè)信息】，選擇左側(cè)有權(quán)限可管理的組織，然后點(diǎn)擊【API配置】，即可獲取Eid，Esecret，也可以在此設(shè)置IP白名單，如下圖所示。

3、理解協(xié)議

企業(yè)API申請(qǐng)后，企業(yè)就可以通過(guò)理解企業(yè)API協(xié)議進(jìn)行接口調(diào)用。