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

01 SNoti 服務功能

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

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

SNoti 服務的能力包括：

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

◆ 設備數據傳輸平均時長40-50ms；

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

◆ 支持 SSL 傳輸；

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

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

02 企業(yè) OPEN API

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

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

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

03案例介紹說明

充電樁 SaaS 平臺

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

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

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

分時租賃系統(tǒng)

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

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

04 開發(fā)流程介紹

SNoti 服務接入

1、提出申請

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

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

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

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

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

2、獲取參數

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

3、理解協(xié)議

具體協(xié)議見：

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

4、按需實現客戶端

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

◆ 解析 SNoti 服務推送的 JSON 報文

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

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

5、通過虛擬設備模擬真實設備推送數據

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

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

◆ 在該產品下并定義了數據點；

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

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

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

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

可查看已開通的服務，如下圖。

2、獲取參數

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

3、理解協(xié)議

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