基于NB-IoT的供熱業(yè)務(wù) 室溫采集器應(yīng)用平臺接口技術(shù)要求

3基于NB-loT的供熱業(yè)務(wù)室溫采集器應(yīng)用平臺接口技術(shù)要求本文件規(guī)定了基于NB-IoT的室溫采集器應(yīng)用平臺接口技術(shù)要求，包含平臺系統(tǒng)架構(gòu)、平臺接口協(xié)議、業(yè)務(wù)流程、接口定義要求。本文件適用于NB-IoT室溫采集器產(chǎn)品設(shè)計和研發(fā)，適用于政府供熱監(jiān)管部門、供熱企事業(yè)單位室溫采集器應(yīng)用平臺建設(shè)的決策參考，也適用于第三方機構(gòu)對NB-IoT室溫采集器技術(shù)審查和評估。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款，其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件。不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。YD/TAAAA-AAAA基于NB-IoT的供熱業(yè)務(wù)室溫采集器總體技術(shù)要求3術(shù)語和定義下列術(shù)語和定義適用于本文件NB-loT室溫采集器roomtemperatureacquisitionbasedonNB-loT安裝在熱用戶室內(nèi)固定位置，內(nèi)置溫度傳感或變送器件采集室內(nèi)溫度，并通過內(nèi)置NB-IoT基礎(chǔ)通信套件和用戶卡把采集溫度上傳至NB-IoT物聯(lián)網(wǎng)平臺的電子設(shè)備。此基礎(chǔ)通信套件實現(xiàn)物聯(lián)網(wǎng)終端與NB-IoT物聯(lián)網(wǎng)平臺的通信、應(yīng)用數(shù)據(jù)傳輸及設(shè)備管理等功能。此用戶卡作為用戶身份標(biāo)識，采用物聯(lián)網(wǎng)專用號段，基于NB-IoT網(wǎng)絡(luò)通信/主要提供存儲安全數(shù)據(jù)、動態(tài)加載更新應(yīng)用、安全運算、標(biāo)識用戶身份、鑒權(quán)接入等功能。NB-IoT物聯(lián)網(wǎng)平臺narrowbandinterne為NB-IoT室溫采集器提供接入服務(wù)、連接管理、設(shè)備管理、數(shù)據(jù)緩存及轉(zhuǎn)發(fā)、應(yīng)用使能服務(wù)的物聯(lián)網(wǎng)平臺。業(yè)務(wù)平臺serviceplatform為NB-IoT室溫采集器提供終端管理、用戶管理、客戶交互界面的供熱行業(yè)的業(yè)務(wù)平臺。44符號和縮略語下列縮略語適用于本文件。API:應(yīng)用程序接口(ApplicationProgrammingInterface)header:標(biāo)頭，是服務(wù)器HTTP協(xié)議傳HIML資料到瀏覽器前所送出的字串HTTPS:超文本傳輸安全協(xié)議(HyperTextTransferProtocoloverSecureSocketLayer)IMEI:國際移動設(shè)備識別碼(InternationalMobileEquipmentIdentity)IMSI:國際移動用戶識別碼(InternationalMobileSubscriberIdentity)IoT:物聯(lián)網(wǎng)(InternetofThings)JSON:JavaScript對象簡譜(JavaScriptObjectNotation),一種輕量級的數(shù)據(jù)交換格式5系統(tǒng)架構(gòu)系統(tǒng)架構(gòu)應(yīng)符合YD/TAAAA-AAAA第6章的定義。通信運營商NB-IoT物聯(lián)網(wǎng)平臺和熱力公司業(yè)務(wù)平臺之間是多對多關(guān)系，此處的業(yè)務(wù)平臺是指熱力公司的設(shè)備管理業(yè)務(wù)平臺。6平臺接口協(xié)議概述為滿足NB-IoT物聯(lián)網(wǎng)平臺與業(yè)務(wù)平臺、安全認(rèn)證平臺之間的業(yè)務(wù)及管理要求，本文件對這三個平臺之間的業(yè)務(wù)流程、接口定義進(jìn)行規(guī)范通信運營商物聯(lián)網(wǎng)平臺設(shè)備接入過程如下：1)熱力公司登錄通信運營商NB-IoT物聯(lián)網(wǎng)平臺，注冊新的NB-IoT物聯(lián)網(wǎng)采集器，分配唯一的編號2)熱力公司可在自己業(yè)務(wù)平臺上給NB-IoT物聯(lián)網(wǎng)采集器分配一個設(shè)備廠家出場時的設(shè)備編號；3)熱力公司可在通信運營商NB-IoT物聯(lián)網(wǎng)平臺給deviceld關(guān)聯(lián)(2)中的設(shè)備編號，作為別稱：4)熱力公司在業(yè)務(wù)平臺上填寫通信運營商NB-IoT物聯(lián)網(wǎng)平臺分配的編號完成匹配5)熱力公司的業(yè)務(wù)平臺可向NB-IoT物聯(lián)網(wǎng)平臺下發(fā)注冊添加NB-IoT室溫采集器指令，流程如圖1所示：5業(yè)務(wù)平臺業(yè)務(wù)平臺NB-1oT物聯(lián)網(wǎng)平臺使用App_Key和IMEI發(fā)送注冊請求返回注冊信息圖1注冊NB-loT室溫采集器流程6)NB-IoT平臺會周期性的給業(yè)務(wù)平臺推送數(shù)據(jù)，例如溫度數(shù)據(jù)、時間等，業(yè)務(wù)平臺收到后認(rèn)為設(shè)備注冊成功，可正常使用。7.2查詢設(shè)備基礎(chǔ)信息業(yè)務(wù)平臺可向NB-IoT物聯(lián)網(wǎng)平臺下發(fā)查詢NB-IoT室溫采集器基礎(chǔ)信息指令，流程如圖2所示；下發(fā)基礎(chǔ)信息查詢請求返回基礎(chǔ)信息詳情圖2查詢NB-loT室溫采集器基礎(chǔ)信息流程7.3查詢設(shè)備在線狀態(tài)6下發(fā)刪除請求返回刪除結(jié)果信息7.7數(shù)據(jù)查詢業(yè)務(wù)平臺可向NB-IoT物聯(lián)網(wǎng)平臺下發(fā)數(shù)據(jù)查詢指令，流程如圖7所示。圖7數(shù)據(jù)查詢流程業(yè)務(wù)平臺可向NB-IoT物聯(lián)網(wǎng)平臺下發(fā)設(shè)備遠(yuǎn)程設(shè)置指令，指令到達(dá)后，NB-IoT物聯(lián)網(wǎng)平臺緩存待設(shè)備下一次上線后把指令下發(fā)，設(shè)備返回設(shè)置指令的響應(yīng)結(jié)果，流程如圖8所示。業(yè)務(wù)平臺NB-IoT物聯(lián)網(wǎng)平臺下發(fā)設(shè)置請求返回設(shè)置結(jié)果信息推送指令設(shè)置結(jié)果信息返回推送處理結(jié)果8.1通用接口NB-IoT室溫采集器在NB-IoT物聯(lián)網(wǎng)平臺注冊成功后，此平臺向業(yè)務(wù)平臺發(fā)送注冊結(jié)果通知消息，需要約定通用結(jié)果和公共參數(shù)。用戶可通過HTTPS調(diào)用，開展NB-IoT室溫采集器設(shè)備管理、數(shù)據(jù)查詢、日常抄表等操作，在API的基礎(chǔ)上根據(jù)用戶個性化需求搭建上層應(yīng)用。此時，發(fā)起方是NB-IoT物聯(lián)網(wǎng)平臺，接收方是業(yè)務(wù)平臺。AppID編碼應(yīng)滿足以下要求；a)數(shù)據(jù)類型為字符串：b)顯示名稱為應(yīng)用D?c)字段描述是NB-IoT物聯(lián)網(wǎng)平臺頒發(fā)的應(yīng)用唯一標(biāo)識；d)不應(yīng)超過255個字節(jié)。deviceID編碼應(yīng)滿足以下要求：a)數(shù)據(jù)類型為字符串：b)顯示名稱為設(shè)備ID;c)字段描述是NB-IoT室溫采集器在平臺側(cè)的設(shè)備唯一標(biāo)識碼：d)不應(yīng)超過255個字節(jié)。8.1.1接口整體結(jié)構(gòu)請求方法需要符合Restful格式，其中添加類的請求采用post、查詢類的請求采用get、刪除類delete、修改類的請求采用put.接口地址：https://ldomain)/模塊/(nethod},接口域domain即標(biāo)識接口所屬的模塊。接口首行，應(yīng)出現(xiàn)appId消息體：包括公共、業(yè)務(wù)參數(shù)兩部分。返回結(jié)果定義見表1。表1返回結(jié)果定義須是是否返回結(jié)果詳情見表2。0123456789