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

01 SNoti 服務(wù)功能

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

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

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

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

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

◆ 支持多客戶端同時請求；

◆ 支持 SSL 傳輸；

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

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

02 企業(yè) OPEN API

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

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

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

03案例介紹說明

充電樁 SaaS 平臺

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

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

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

分時租賃系統(tǒng)

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

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

04 開發(fā)流程介紹

SNoti 服務(wù)接入

1、提出申請

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

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

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

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

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

2、獲取參數(shù)

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

3、理解協(xié)議

具體協(xié)議見：

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2、獲取參數(shù)

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

3、理解協(xié)議

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