DB5120T 29.3-2024感知信息共享應(yīng)用規(guī)范 第3部分：物聯(lián)感知平臺接入管理

35.240.01L70DB5120DB5120/T29.3—20242024-12-12發(fā)布2024-12-27實施資陽市市場監(jiān)督管理局發(fā)布IDB5120/T29.3—2024前言 II 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5總體架構(gòu) 6接入方式概覽 7設(shè)備通信能力要求 8設(shè)備接入?yún)f(xié)議 9設(shè)備物模型 10設(shè)備鑒權(quán)方式 11應(yīng)用側(cè)訪問與接入方式 附錄A（資料性）Topic對應(yīng)的業(yè)務(wù)參數(shù)及開發(fā)指南 附錄B（資料性）JSON格式轉(zhuǎn)換示例 附錄C（資料性）設(shè)備屬性應(yīng)用示例 附錄D（資料性）請求URI示例 附錄E（資料性）鑒權(quán)認(rèn)證示例 參考文獻(xiàn) IIDB5120/T29.3—2024本文件對資陽市物聯(lián)網(wǎng)存量、新建時，物聯(lián)網(wǎng)設(shè)備統(tǒng)一接入資陽市物聯(lián)感知平臺提出技術(shù)規(guī)范，包括設(shè)備接入方式、通信能力、安全要求、數(shù)據(jù)規(guī)范、應(yīng)用接入要求等內(nèi)容。本文件按照GB/T1.1-2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由資陽市政務(wù)服務(wù)管理局提出并歸口。本文件起草單位:資陽市政府政務(wù)服務(wù)和公共資源交易服務(wù)中心、資陽市大數(shù)據(jù)服務(wù)中心、資陽乾耀信創(chuàng)科技有限責(zé)任公司、成都工貿(mào)職業(yè)技術(shù)學(xué)院、四川省職業(yè)技能鑒定指導(dǎo)中心。本文件主要起草人:劉桄序、劉光乾、李天祥、胡穎梅、李沙、戢培全、邵柏華、張亞琴、楊建康、袁嘉、鄧森林、彭國林、任良華、戢昕蕾、曾毅偉、陳杜宇、劉云峰、卓先德、夏榮、張潤澤、鄭雪梅、李強、蘇熠。1DB5120/T29.3—2024感知信息共享應(yīng)用規(guī)范第3部分：物聯(lián)感知平臺接入管理1范圍本文件規(guī)定了物聯(lián)感知設(shè)備接入物聯(lián)感知平臺的管理規(guī)范，包含術(shù)語和定義、縮略語、整體架構(gòu)、接入方式概覽、設(shè)備通信能力要求、設(shè)備接入?yún)f(xié)議、設(shè)備物模型、設(shè)備鑒權(quán)方式、應(yīng)用側(cè)訪問與接入方式內(nèi)容。本文件適用于資陽市行政區(qū)域內(nèi)政務(wù)組織、非政務(wù)組織和個人擁有可能接入的物聯(lián)感知及視頻采集端的要求管理和使用。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260中華人民共和國行政區(qū)劃代碼GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級保護基本要求GB/T28181公共安全視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求GB/T36620面向智慧城市的物聯(lián)網(wǎng)技術(shù)應(yīng)用指南GB/T36478.4物聯(lián)網(wǎng)信息交換和共享第4部分：數(shù)據(jù)GB/T37024信息安全技術(shù)物聯(lián)網(wǎng)感知層網(wǎng)關(guān)安全技術(shù)要求GB/T37093信息安全技術(shù)物聯(lián)網(wǎng)感知層接入通信網(wǎng)的安全要求GB/T38624.1物聯(lián)網(wǎng)網(wǎng)關(guān)第1部分：面向感知設(shè)備接入的網(wǎng)關(guān)技術(shù)要求GB/T38606物聯(lián)網(wǎng)標(biāo)識體系數(shù)據(jù)內(nèi)容標(biāo)識符GB/T38656特種設(shè)備物聯(lián)網(wǎng)系統(tǒng)數(shù)據(jù)交換技術(shù)規(guī)范GB/T40688物聯(lián)網(wǎng)生命體征感知設(shè)備數(shù)據(jù)接口GB/T40687物聯(lián)網(wǎng)生命體征感知設(shè)備通用規(guī)范GB/T42196公安物聯(lián)網(wǎng)視頻圖像元數(shù)據(jù)分析技術(shù)要求GB/T42197公安物聯(lián)網(wǎng)視頻圖像內(nèi)容元數(shù)據(jù)描述規(guī)范GB/Z41294物聯(lián)網(wǎng)應(yīng)用協(xié)議受限應(yīng)用協(xié)議（CoAP）技術(shù)要求3術(shù)語和定義2DB5120/T29.3—2024以上“規(guī)范性引用文件”中所引用標(biāo)準(zhǔn)界定以及下列術(shù)語和定義適用于本文件。為設(shè)備提供安全可靠的連接通信能力，向下連接海量物聯(lián)網(wǎng)設(shè)備，支撐物聯(lián)網(wǎng)設(shè)備數(shù)據(jù)采集上云和遠(yuǎn)程控制；向上提供云端API，供業(yè)務(wù)應(yīng)用調(diào)用，快速實現(xiàn)高效、低成本、易擴展的物聯(lián)網(wǎng)支撐平臺。物聯(lián)網(wǎng)設(shè)備IoTdevice處于物聯(lián)網(wǎng)感知控制域，具備與外部系統(tǒng)雙向通信能力，用于收集物理世界的信息并能夠發(fā)送或接受處理外部命令的裝置。4縮略語下列縮略語適用于本文件。5總體架構(gòu)物聯(lián)感知平臺（以下也稱IoT平臺、IoTDA（IoTDeviceAccess包括以下3種接入平臺的方式:設(shè)備直連、網(wǎng)關(guān)接入、平臺對接。新建物聯(lián)網(wǎng)設(shè)備應(yīng)按設(shè)備直連平臺或通過網(wǎng)關(guān)接入兩種方式接入。3DB5120/T29.3—2024圖1物聯(lián)感知平臺接入架構(gòu)6接入方式概覽總物聯(lián)網(wǎng)設(shè)備接入平臺，可以通過消息，命令，屬性的方式和設(shè)備進行通信。設(shè)備要提供詳細(xì)的位置信息，包括但不限于經(jīng)緯度、街道等，相關(guān)信息可以由設(shè)備信息上的資產(chǎn)屬性和擴展信息承載。物聯(lián)網(wǎng)設(shè)備接入平臺不接入視頻感知源設(shè)備。設(shè)備命名要符合業(yè)務(wù)要求，設(shè)備名稱只允許中文、字母、數(shù)字、以及_?'#().,&%@!-等字符的組合，建議不少于4個字符。具體命名要符合項目要求，要盡可能體現(xiàn)該設(shè)備的基本能力和該設(shè)備的一些必要根據(jù)設(shè)備所處網(wǎng)絡(luò)情況，以及設(shè)備使用的接入?yún)f(xié)議，需要靈活選擇設(shè)備接入方式。物聯(lián)網(wǎng)接入平臺有設(shè)備直連接入方式與網(wǎng)關(guān)接入方式；使用Mqtt/Coap/http協(xié)議接入的設(shè)備，可以采用直連接入方式，此方式為物聯(lián)網(wǎng)平臺的標(biāo)準(zhǔn)接入方式，使用對應(yīng)的設(shè)備側(cè)標(biāo)準(zhǔn)sdk，在云端定義好物模型，在設(shè)備側(cè)進行開發(fā)適配，以物聯(lián)網(wǎng)設(shè)備接入平臺標(biāo)準(zhǔn)的數(shù)據(jù)格式接收上報數(shù)據(jù)，即可完成設(shè)備接入。網(wǎng)關(guān)接入方式，由于涉及場景較為復(fù)雜，與具體接入場景關(guān)系緊密，往往需要專門進行適配和開發(fā)，為非標(biāo)準(zhǔn)接入方式，具體實施需項目組單獨評估規(guī)劃。推薦接入策略如下：a）設(shè)備使用CoAP/LWM2M方式接入，建議采用設(shè)備直連方式接入物聯(lián)感知平臺。該方式為物聯(lián)網(wǎng)接入平臺的標(biāo)準(zhǔn)接入方式，使用標(biāo)準(zhǔn)的IoTDeviceSDKTiny接入即可；b）設(shè)備使用Mqtt協(xié)議，建議采用設(shè)備直連方式接入物聯(lián)感知平臺，設(shè)備也可以采用網(wǎng)關(guān)接入方式。該方式為物聯(lián)網(wǎng)接入平臺的標(biāo)準(zhǔn)接入方式，使用標(biāo)準(zhǔn)的IoTDeviceSDK接入即可。實施需項目組單獨評估規(guī)劃并申請經(jīng)費。d）設(shè)備數(shù)據(jù)，需要通過查詢第三方系統(tǒng)api，或者查詢第三方數(shù)據(jù)庫才可以獲取，推薦采用網(wǎng)關(guān)接入方式。具體實施需項目組單獨評估規(guī)劃并申請經(jīng)費。e）設(shè)備本身無法直接連接到物聯(lián)感知平臺，建議在設(shè)備周圍部署一個可以和平臺直連的網(wǎng)關(guān)，將設(shè)備與網(wǎng)關(guān)對接，然后網(wǎng)關(guān)統(tǒng)一上報到物聯(lián)感知平臺。此場景，建議采用網(wǎng)關(guān)接入方式接入物聯(lián)感知平臺。具體實施需項目組單獨評估規(guī)劃并申請經(jīng)費。f）如設(shè)備無法主動上報數(shù)據(jù)，需要采用特定方式，采集設(shè)備相關(guān)數(shù)據(jù)，推薦使用網(wǎng)關(guān)接入方式對4DB5120/T29.3—2024接物聯(lián)感知平臺。具體實施需項目組單獨評估規(guī)劃并申請經(jīng)費。g）設(shè)備數(shù)據(jù)使用plc上報，推薦使用網(wǎng)關(guān)接入方式對接。具體實施需項目組單獨評估規(guī)劃并申請經(jīng)費。h）設(shè)備數(shù)據(jù)是先匯聚到scada系統(tǒng)，則推薦采用網(wǎng)關(guān)方式對接。具體實施需項目組單獨評估規(guī)劃并申請經(jīng)費。j）設(shè)備是采用其他非標(biāo)準(zhǔn)協(xié)議，如jt808(應(yīng)用于交通領(lǐng)域),hj212（應(yīng)用于環(huán)境領(lǐng)域）,sl651（應(yīng)用于水里領(lǐng)域）等，且希望與平臺直連，則可以采用泛協(xié)議接入方式對接。具體實施需項目組單獨評估規(guī)劃并申請經(jīng)費。平臺提供了兩種SDK，它們之間的主要區(qū)別如表1所示。表1兩種SDK區(qū)別SDK種類SDK集成場景SDK支持的物聯(lián)網(wǎng)通信協(xié)議面向運算、存儲能力較強的嵌入式設(shè)備，例如網(wǎng)關(guān)、采集器等。面向?qū)?、存儲、計算資源有苛刻限制的終端設(shè)備，例如單片機、模組。7設(shè)備通信能力要求物聯(lián)網(wǎng)設(shè)備主流接入方式有固網(wǎng)、2G/3G/4G/5G/NB-IoT、WLAN，用戶可以根據(jù)物聯(lián)網(wǎng)應(yīng)用場景從覆蓋面、時延、部署方式、組網(wǎng)形式等方面來選擇通信方式對接物聯(lián)感知平臺，并在項目規(guī)劃階段選擇合適的設(shè)備廠商進行合作。固定網(wǎng)絡(luò)接入（如通過RJ45有線網(wǎng)口、光模塊等需要用戶將物聯(lián)網(wǎng)設(shè)備的網(wǎng)絡(luò)接入到整個工廠、園區(qū)或交通設(shè)施等應(yīng)用場景中。固定網(wǎng)絡(luò)能夠帶來穩(wěn)定可靠的網(wǎng)絡(luò)連接，網(wǎng)絡(luò)帶寬、時延可以根據(jù)項目實際情況按需綜合設(shè)計與實施，但固定的網(wǎng)口也限制了設(shè)備的種類和用途，適用于部署位置可以相對固定的設(shè)備，如充電樁、中央空調(diào)、門禁閘機等等。設(shè)備網(wǎng)絡(luò)接口要求如表2所示。表2網(wǎng)絡(luò)接口要求類型項目規(guī)格備注必選帶寬大小可根據(jù)承載的數(shù)據(jù)類型選擇IP類型優(yōu)先IPv6可選支持簡化現(xiàn)場布線7.3運營商傳統(tǒng)蜂窩網(wǎng)絡(luò)（2G/3G/4G/5G）運營商網(wǎng)絡(luò)接入（2G/3G/4G/5G）要求設(shè)備提供商選擇合適的運營商，并購買對應(yīng)的物聯(lián)網(wǎng)SIM卡。設(shè)備則需要有能支持選定網(wǎng)絡(luò)制式的基帶芯片。運營商網(wǎng)絡(luò)接入依托現(xiàn)有的基站網(wǎng)絡(luò)，有著廣覆蓋、快速接入的特點?？筛鶕?jù)物聯(lián)網(wǎng)應(yīng)用場景選擇對應(yīng)網(wǎng)絡(luò)制式，2G到5G帶寬性能、時延性能依次升高，但相應(yīng)設(shè)備芯片成本也相應(yīng)提升。設(shè)備網(wǎng)絡(luò)制式要求如表3所示。表3網(wǎng)絡(luò)制式5DB5120/T29.3—2024項目規(guī)格備注網(wǎng)絡(luò)制式4G:TD-LTE/LTEFDD具體制式可根據(jù)場地運營商支持情況、帶寬時延要求、功耗成本要求選擇網(wǎng)絡(luò)制式具體制式可根據(jù)場地運營商支持情況、帶寬時延要求、功耗成本要求選擇對于高帶寬、低延遲以及高可靠場景，推薦采用5G網(wǎng)絡(luò)切片構(gòu)建虛擬專網(wǎng)，結(jié)合物聯(lián)感知平臺下沉的混合云方案，從而提高可靠性以及保障極致性能。2G網(wǎng)絡(luò)正在逐步退網(wǎng)，不推薦使用，建議采用4G網(wǎng)絡(luò)的Cat.1替代。7.4運營商窄帶網(wǎng)絡(luò)（NB-IoT）在物聯(lián)網(wǎng)領(lǐng)域，NB-IoT比傳統(tǒng)蜂窩網(wǎng)絡(luò)有更強的競爭力和更加旺盛的生命力。工信部《工業(yè)和信息化部辦公廳關(guān)于深入推進移動物聯(lián)網(wǎng)全面發(fā)展的通知》則明確要求推動2G/3G物聯(lián)網(wǎng)業(yè)務(wù)轉(zhuǎn)網(wǎng)，能夠遷移到NB-IoT等技術(shù)生態(tài)上來。NB-IoT相較傳統(tǒng)蜂窩網(wǎng)絡(luò)在同頻段下，可以獲得20dB更多的增益，因而擁有更強的覆蓋能力。NB網(wǎng)絡(luò)單扇區(qū)可以支持10萬個連接，時延敏感度低，同時設(shè)備成本及功耗低，適合遠(yuǎn)程抄表、智慧農(nóng)業(yè)、資產(chǎn)跟蹤等業(yè)務(wù)。設(shè)備通過NB-IoT網(wǎng)絡(luò)需實時控制設(shè)備時，需組建專線網(wǎng)絡(luò)：設(shè)備通NB-IoT網(wǎng)絡(luò)連接，推送CoAP下行消息，需要等待NB設(shè)備主動連線后才能下發(fā)，因此下行消息根據(jù)CoAP心跳時間會有不同的延時。這是由于運營商公共地址池和NB-IoT設(shè)備的映射表會老化，平臺無法找到消息下行時刻的設(shè)備地址。在NB-IoT要求消息下行能夠?qū)崟r送到的場景，需委托電信運營商組建專線網(wǎng)絡(luò)。在平臺和NB設(shè)備所在EPC之間搭建專線或建立基于公網(wǎng)的VPN（GRE/IPSec）等，以保證平臺消息下行時能夠正常地進行設(shè)備尋址。7.5無線局域網(wǎng)（WLAN）無線局域網(wǎng)（WLAN）在物聯(lián)網(wǎng)行業(yè)使用較為廣泛的接入方式，主流物聯(lián)網(wǎng)設(shè)備對WLAN的支持非常充分，可根據(jù)用戶需求選擇部署在專網(wǎng)或者公網(wǎng)，根據(jù)物聯(lián)網(wǎng)應(yīng)用場景可自定WLAN覆蓋范圍。但是WLAN不適合高密覆蓋，高密場景下鄰?fù)l干擾將導(dǎo)致時延和帶寬性能下降，并影響傳輸可靠性，需要用戶在網(wǎng)規(guī)網(wǎng)設(shè)階段合理設(shè)置WLAN覆蓋容量。設(shè)備WLAN接入規(guī)格要求如表4所示。表4WLAN接入規(guī)格類型項目規(guī)格備注必選頻段信道信道使用需符合當(dāng)?shù)胤ㄒ?guī)標(biāo)準(zhǔn)帶寬可選支持簡化現(xiàn)場布線頻段獲得更高的帶寬，但犧牲覆蓋7.6通過網(wǎng)關(guān)接入網(wǎng)絡(luò)要求6DB5120/T29.3—2024在實際應(yīng)用場景，基于功耗、成本的考慮，如某些溫濕度傳感器、煙霧報警器等超低功耗、低帶寬等進場通信協(xié)議接入。此場景需要經(jīng)終端的網(wǎng)關(guān)做數(shù)據(jù)轉(zhuǎn)換對接到物聯(lián)感知平臺。8設(shè)備接入?yún)f(xié)議8.1MQTT/MQTTS協(xié)議接入終端設(shè)備通過原生MQTT/MQTTS接入物聯(lián)感知平臺，物聯(lián)感知平表5所示。表5MQTT/MQTTS協(xié)議描述與標(biāo)準(zhǔn)MQTT協(xié)議的區(qū)別單個設(shè)備最大MQTT連接數(shù)1單個MQTT連接每秒的吞吐量，即帶寬，包含直連設(shè)備和網(wǎng)關(guān)MQTT單個發(fā)布消息最大長度，超過此大小的發(fā)布請求將被直接拒絕MQTT連接心跳時間建議值秒8.2LwM2M/CoAP協(xié)議接入目前LWM2M/CoAP協(xié)議主要用在NB-IoT場景上，業(yè)務(wù)數(shù)據(jù)交互端口是物聯(lián)感知平臺的5684端口，5684端口走DTLS+CoAP協(xié)議通道接入，NB-IoT設(shè)備端接入時提供必要的數(shù)據(jù)憑證，并支持標(biāo)準(zhǔn)DTLS協(xié)議。設(shè)備在登錄平臺前，需將設(shè)備對接平臺的端口設(shè)置為5684（即走DTLS加密通道）。將設(shè)備出廠前的PSK秘鑰預(yù)置到物聯(lián)感知平臺中，PSK秘鑰的數(shù)據(jù)類型為String型，長度范圍為8-32位。8.3泛協(xié)議設(shè)備接入目前平臺支持基于MQTT/LWM2M等標(biāo)準(zhǔn)協(xié)議接入，為解決用戶自定義處理設(shè)備數(shù)據(jù)以及自定義協(xié)議設(shè)備快速接入IOT平臺的訴求。華為云IoT提供泛協(xié)議適配機制，您可使用泛協(xié)議對接SDK，快速構(gòu)建橋接服務(wù)，搭建設(shè)備或平臺與IoT的雙向數(shù)據(jù)通道。8.4使用場景設(shè)備只支持某種類型協(xié)議，而平臺目前不支持該協(xié)議。設(shè)備與其接入服務(wù)器之間已有通信網(wǎng)絡(luò)，您希望在不修改設(shè)備和協(xié)議的情況下，將設(shè)備接入IOT平由于設(shè)備硬件資源或者網(wǎng)絡(luò)限制，設(shè)備無法直接接入IOT平臺。7DB5120/T29.3—20249設(shè)備物模型9.1物模型概述設(shè)備物模型用于描述設(shè)備具備的能力和特性。為統(tǒng)一各設(shè)備廠家的設(shè)備模型，方便應(yīng)用與設(shè)備解耦，要求設(shè)備都使用物模型的方式接入。設(shè)備物模型在物聯(lián)感知平臺構(gòu)建一款設(shè)備的抽象模型，使平臺理解該款設(shè)備支持的服務(wù)、屬性、命令等信息，如顏色、開關(guān)等。當(dāng)定義完一款設(shè)備物模型后，在進行注冊設(shè)備時，就可以使用該模型詳見圖2所示。圖2設(shè)備物模型設(shè)備物模型包括產(chǎn)品信息和服務(wù)能力：a）產(chǎn)品信息描述一款設(shè)備的基本信息，包括廠商ID、廠商名稱、設(shè)備類型、協(xié)議類型。協(xié)議類型為“CoAP”。b）服務(wù)能力描述設(shè)備具備的業(yè)務(wù)能力。將設(shè)備業(yè)務(wù)能力拆分成若干個服務(wù)后，再定義每個服務(wù)具備的屬性、命令以及命令的參數(shù)。9.2物模型接入的方式9.2.1基于具體設(shè)備定義好物模型后，就可以基于物模型接入物聯(lián)感知平臺。MQTT協(xié)議設(shè)備支持平臺標(biāo)準(zhǔn)接口接入、編解碼插件接入，而NB-IoT設(shè)備只支持編解碼插件接入。9.2.2平臺標(biāo)準(zhǔn)接口接入：物聯(lián)感知平臺預(yù)置了數(shù)據(jù)、消息、事件上報，以及命令、消息、事件下發(fā)等典型場景的MQTTTopic，設(shè)備廠商可根據(jù)業(yè)務(wù)特點按需實現(xiàn)集成。9.2.3平臺標(biāo)準(zhǔn)接口數(shù)據(jù)格式。a）設(shè)備命令平臺命令下發(fā)：用于平臺向設(shè)備下發(fā)設(shè)備控制命令。平臺下發(fā)命令后，需要設(shè)備及時將命令的執(zhí)行結(jié)果返回給平臺，設(shè)備沒回響應(yīng)，平臺會認(rèn)為命令執(zhí)行超時。命令下發(fā)和消息下發(fā)的區(qū)別，請查看消息通信說明。b)通過編解碼插件接入平臺為實現(xiàn)非標(biāo)接口和數(shù)據(jù)格式兼容，以及非MQTT的物聯(lián)網(wǎng)協(xié)議兼容，支持設(shè)備廠商開發(fā)編解碼插件(JavaScript)，設(shè)備廠商應(yīng)在編解碼轉(zhuǎn)換層，將特定設(shè)備的接口和數(shù)據(jù)格式轉(zhuǎn)換為平臺標(biāo)準(zhǔn)的格式類型。8DB5120/T29.3—202410設(shè)備鑒權(quán)方式a)通過設(shè)備密鑰方式鑒權(quán)。通過物聯(lián)感知平臺注冊設(shè)備后，獲得的DeviceId和Secret將用于設(shè)備南向鑒權(quán)。設(shè)備側(cè)應(yīng)支持MQTT協(xié)議的connect消息接口，接口規(guī)范參考MQTT標(biāo)準(zhǔn)規(guī)范，鑒權(quán)通過后建立設(shè)備與平臺間的MQTT連接，參考的參數(shù)表6所示。表6密鑰方式鑒權(quán)參數(shù)可選類型參數(shù)描述必選設(shè)備clientId由3個部分組成：設(shè)備ID、設(shè)備身份標(biāo)識類型、用戶標(biāo)識ID（ScopeID）。通過下劃線“_”分隔，設(shè)備身份標(biāo)識類型固定值為0。其他場景：設(shè)備clientId由4個部分組成：設(shè)備ID、設(shè)備身份標(biāo)識類型、密碼簽名類型、時間戳。通過下劃線“_”分隔，設(shè)備身份標(biāo)識類型固定值為0密碼簽名類型：長度1字節(jié)，當(dāng)前支持時間戳：為設(shè)備連接平臺時的UTC時間，格式為必選設(shè)備ID。必選認(rèn)證接入(SECRET)可填寫該字段。b)通過X.509設(shè)備證書方式鑒權(quán)。設(shè)備使用證書認(rèn)證鑒權(quán)，除滿足ClientId要設(shè)備能夠支持X.509證書方式與平臺鑒權(quán)。設(shè)備通過LwM2M接入需實現(xiàn)Register功能進行南向接入鑒權(quán)，各參數(shù)參考如表7所示。表7Registe接入規(guī)范參數(shù)名參數(shù)位置可選/必選說明必選生命周期設(shè)備版本必選設(shè)備支持的對象和實例11應(yīng)用側(cè)訪問與接入方式9DB5120/T29.3—2024物聯(lián)感知平臺把自身豐富的管理能力通過API的形式對外開放，包括產(chǎn)品管理、設(shè)備管理、設(shè)備組管理、標(biāo)簽管理、設(shè)備CA證書管理、設(shè)備影子、設(shè)備命令、設(shè)備消息、設(shè)備屬性、訂閱管理、規(guī)則管理、批量任務(wù)等，幫助用戶快速構(gòu)筑基于物聯(lián)感知平臺的行業(yè)應(yīng)用。11.2API約束物聯(lián)感知平臺提供了RESTful風(fēng)格API，支持用戶通過HTTPS請求調(diào)用。為保障物聯(lián)感知平臺與其他信息系統(tǒng)對接的功能完整性與可靠性，應(yīng)用側(cè)接入系統(tǒng)需要滿足以下要求：a）API的演進會保持前向兼容性，若接口升級了版本，其舊版本接口可以繼續(xù)使用，但功能不再做增強，新增功能僅在新版本接口中提供。b）應(yīng)用在接收處理物聯(lián)感知平臺發(fā)送的響應(yīng)消息和推送消息時，需要兼容或忽略消息中的新增參數(shù)，不能因為消息中的新增參數(shù)導(dǎo)致應(yīng)用的處理異常。c）在應(yīng)用側(cè)調(diào)用API的同步接口時，諸如“下發(fā)設(shè)備命令”，“查詢設(shè)備屬性”，“修改設(shè)備屬性”等，需要在設(shè)備在線后訂閱對應(yīng)的平臺下行Topic，對平臺下行指令進行回復(fù)響應(yīng)。否則應(yīng)用側(cè)同步接d）在應(yīng)用側(cè)調(diào)用API的異步接口時，諸如“查詢設(shè)備消息”，“下發(fā)設(shè)備消息”等，允許設(shè)備在線后訂閱對應(yīng)的平臺下行Topic，對平臺下行指令回復(fù)或不回復(fù)響應(yīng)。也支持設(shè)備不在線，應(yīng)用側(cè)異步接口執(zhí)行不會超時。11.3API調(diào)用方法構(gòu)造請求：本節(jié)介紹RESTAPI請求的組成，并以調(diào)用物聯(lián)感知平臺的查詢產(chǎn)品和創(chuàng)建產(chǎn)品接口說明如何調(diào)用API，該API可用于獲取用戶的指定產(chǎn)品信息。11.4認(rèn)證鑒權(quán)調(diào)用接口有如下兩種認(rèn)證方式，用戶可以選擇其中一種進行認(rèn)證鑒權(quán)。DB5120/T29.3—2024附錄ATopic對應(yīng)的業(yè)務(wù)參數(shù)及開發(fā)指南A.1Topic對應(yīng)的業(yè)務(wù)參數(shù)及開發(fā)指南應(yīng)符合表A.1規(guī)則舉例：資陽市雁江區(qū)住建局互聯(lián)網(wǎng)揚塵檢測點位：中心編碼（資陽市雁江區(qū)641300、基層接入單位暫定00）、行業(yè)編碼（環(huán)境接入11）、類型編碼（揚塵檢測感知終端600）、網(wǎng)絡(luò)標(biāo)識（Internet網(wǎng)7）、表A.1Topic對應(yīng)的業(yè)務(wù)參數(shù)分類主題生產(chǎn)者訂閱者用途設(shè)備消息相關(guān)設(shè)備平臺設(shè)備消息上報平臺設(shè)備平臺下發(fā)消息給設(shè)備設(shè)備命令相關(guān)平臺設(shè)備平臺下發(fā)命令給設(shè)備設(shè)備平臺設(shè)備返回命令響應(yīng)設(shè)備屬性相關(guān)設(shè)備平臺設(shè)備上報屬性數(shù)據(jù)設(shè)備平臺網(wǎng)關(guān)批量上報屬性數(shù)據(jù)平臺設(shè)備平臺設(shè)置設(shè)備屬性設(shè)備平臺屬性設(shè)置的響應(yīng)結(jié)果平臺設(shè)備平臺查詢設(shè)備屬性設(shè)備平臺屬性查詢響應(yīng)結(jié)果，這個結(jié)果不會對設(shè)備屬性和影子產(chǎn)生影響設(shè)備平臺設(shè)備側(cè)主動獲取平臺的設(shè)備影子數(shù)據(jù)DB5120/T29.3—2024（續(xù)）表A.1Topic對應(yīng)的業(yè)務(wù)參數(shù)分類主題生產(chǎn)者訂閱者用途設(shè)備屬性相關(guān)平臺設(shè)備設(shè)備側(cè)主動獲取平臺設(shè)備影子數(shù)據(jù)的響應(yīng)設(shè)備事件相關(guān)設(shè)備平臺設(shè)備事件上報平臺設(shè)備平臺事件下發(fā)DB5120/T29.3—2024附錄BJSON格式轉(zhuǎn)換示例B.1示例低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時，可將原始二進制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實現(xiàn)二進制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。上行：{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)收到下行請求的topic帶該參數(shù)時，上行響應(yīng)的topic需要將該參數(shù)值返回給平臺。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時，可以使用通配#，設(shè)備側(cè)訂閱平臺命令下發(fā)的topic為：下行請求參數(shù)說明字段名必選/可選類型參數(shù)描述可選命令對應(yīng)的目標(biāo)設(shè)備ID，命令下發(fā)對應(yīng)的最終目標(biāo)設(shè)備，沒有攜帶則表示目標(biāo)設(shè)備即topic中指定的設(shè)備?？蛇x設(shè)備的服務(wù)ID，在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義可選設(shè)備命令名稱，在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。可選設(shè)備命令的執(zhí)行參數(shù)，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。上行響應(yīng)參數(shù)說明命令應(yīng)答的json格式，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。字段名必選/可選類型參數(shù)描述可選標(biāo)識命令的執(zhí)行結(jié)果，0表示成功，其他表示失敗。不帶默認(rèn)認(rèn)為成功?？蛇x命令的響應(yīng)名稱，在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義?？蛇x命令的響應(yīng)參數(shù)，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。下行請求示例數(shù)據(jù)格式：{DB5120/T29.3—2024}上行響應(yīng)示例數(shù)據(jù)格式：{DB5120/T29.3—2024附錄C設(shè)備屬性應(yīng)用示例C.1示例a）設(shè)備屬性上報：用于設(shè)備按產(chǎn)品模型中定義的格式將屬性數(shù)據(jù)上報給平臺。屬性上報和消息上報的區(qū)別，請查看消息通信說明。說明：低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時，可將原始二進制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實現(xiàn)二進制數(shù)據(jù)到平臺定義字段名必選/可選類型參數(shù)描述必選設(shè)備服務(wù)數(shù)據(jù)列表（具體結(jié)構(gòu)參考下表參數(shù)說明字段名必選/可選類型參數(shù)描述必選設(shè)備的服務(wù)ID。必選設(shè)備服務(wù)的屬性列表，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義，可以設(shè)置多個字段?？蛇x設(shè)備采集數(shù)據(jù)UTC時間（格式可選：秒級別：設(shè)備上報數(shù)據(jù)不帶該參數(shù)或參數(shù)格式錯誤時，則數(shù)據(jù)上報時間以平臺時間為準(zhǔn)。示例數(shù)據(jù)格式：{},},DB5120/T29.3—2024{},}}b）網(wǎng)關(guān)批量設(shè)備屬性上報用于批量設(shè)備上報屬性數(shù)據(jù)給平臺。網(wǎng)關(guān)設(shè)備可以用此接口同時上報多個子設(shè)備的屬性數(shù)據(jù)。屬性上報和消息上報的區(qū)別，請查看消息通信說明。參數(shù)說明字段名必選/可選類型參數(shù)描述必選設(shè)備數(shù)據(jù)字段名必選/可選類型參數(shù)描述必選設(shè)備ID必選設(shè)備服務(wù)數(shù)據(jù)列表字段名必選/可選類型參數(shù)描述必選設(shè)備的服務(wù)ID。必選設(shè)備服務(wù)的屬性列表，具體字段在產(chǎn)品模型里定義，可以設(shè)置多個字段。可選設(shè)備采集數(shù)據(jù)UTC時間（格式可選：秒級別：設(shè)備上報數(shù)據(jù)不帶該參數(shù)或參數(shù)格式錯誤時，則數(shù)據(jù)上報時間以平臺時間為準(zhǔn)。示例數(shù)據(jù)格式:{{DB5120/T29.3—2024{},}},{{},},{},}}}c）平臺設(shè)置設(shè)備屬性用于平臺設(shè)置設(shè)備屬性。設(shè)備的產(chǎn)品模型中定義了平臺可向設(shè)備設(shè)置的屬性，平臺可調(diào)用此接口設(shè)置指定設(shè)備的屬性數(shù)據(jù)。設(shè)備收到屬性設(shè)置請求后，需要將執(zhí)行結(jié)果返回給平臺，設(shè)備沒回響應(yīng)平臺會認(rèn)為屬性設(shè)置請求執(zhí)行超時。說明低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時，可將原始二進制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實現(xiàn)二進制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。DB5120/T29.3—2024下行:上行:說明{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)收到下行請求的topic帶該參數(shù)時，上行響應(yīng)的topic需要將該參數(shù)值返回給平臺。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時，可以使用#，設(shè)備側(cè)訂閱平臺設(shè)置設(shè)備屬性的topic為：下行請求參數(shù)說明字段名必選/可選類型參數(shù)描述可選屬性設(shè)置對應(yīng)的目標(biāo)設(shè)備ID必選設(shè)備服務(wù)數(shù)據(jù)列表。字段名必選/可選類型參數(shù)描述必選設(shè)備的服務(wù)ID。必選設(shè)備服務(wù)的屬性列表，具體字段在產(chǎn)品模型里定義，可以設(shè)置多個字段。上行響應(yīng)參數(shù)說明字段名必選/可選類型參數(shù)描述可選命令的執(zhí)行結(jié)果，0表示成功，其他表示失敗。不帶默認(rèn)認(rèn)為成功?？蛇x屬性設(shè)置的響應(yīng)描述。下行請求示例數(shù)據(jù)格式：{}},{}DB5120/T29.3—2024}上行響應(yīng)示例數(shù)據(jù)格式：{}d）平臺查詢設(shè)備屬性用于平臺向設(shè)備查詢屬性信息。平臺可調(diào)用此接口查詢設(shè)備的屬性數(shù)據(jù)。設(shè)備收到屬性查詢請求后，需要將設(shè)備的屬性數(shù)據(jù)返回給平臺，設(shè)備沒回響應(yīng)平臺會認(rèn)為屬性查詢請求執(zhí)行超時。說明低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時，可將原始二進制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實現(xiàn)二進制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。上行:說明{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)收到下行請求的topic帶該參數(shù)時，上行響應(yīng)的topic需要將該參數(shù)值返回給平臺。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時，可以使用#，設(shè)備側(cè)訂閱平臺查詢設(shè)備屬性的topic為：下行請求參數(shù)說明字段名必選/可選類型參數(shù)描述可選屬性查詢對應(yīng)的目標(biāo)設(shè)備ID?？蛇x設(shè)備的服務(wù)ID。上行響應(yīng)參數(shù)說明字段名必選/可選類型參數(shù)描述可選設(shè)備服務(wù)數(shù)據(jù)列表。字段名必選/可選類型參數(shù)描述必選設(shè)備的服務(wù)ID。必選設(shè)備服務(wù)的屬性列表，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型里定義，可以設(shè)置多個字段。可選設(shè)備采集數(shù)據(jù)UTC時間（格式：DB5120/T29.3—2024字段名必選/可選類型參數(shù)描述設(shè)備上報數(shù)據(jù)不帶該參數(shù)或參數(shù)格式錯誤時，則數(shù)據(jù)上報時間以平臺時間為準(zhǔn)。下行請求示例數(shù)據(jù)格式：{}上行響應(yīng)示例數(shù)據(jù)格式：{{},}}e)設(shè)備側(cè)獲取平臺的設(shè)備影子數(shù)據(jù)用于設(shè)備向平臺獲取設(shè)備影子數(shù)據(jù)。用戶可以通過應(yīng)用服務(wù)器或物聯(lián)網(wǎng)控制臺修改設(shè)備屬性，設(shè)備上線時訂閱該topic，可以獲取到平臺設(shè)備影子數(shù)據(jù)，以此來同步設(shè)備屬性值，從而完成設(shè)備屬性值的修改。下行響應(yīng):說明{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)發(fā)起的消息帶該參數(shù)時，需要保證設(shè)備側(cè)該參數(shù)值的唯一性，可以用遞增的數(shù)字或者UUID來實現(xiàn)。上行請求參數(shù)說明DB5120/T29.3—2024字段名必選/可選類型參數(shù)描述可選需要獲取設(shè)備影子的目標(biāo)設(shè)備ID?？蛇x需要獲取設(shè)備影子的設(shè)備服務(wù)ID,不帶的話查詢所有服務(wù)ID的設(shè)備影子數(shù)據(jù)。下行響應(yīng)參數(shù)說明字段名必選/可選類型參數(shù)描述必選設(shè)備影子的目標(biāo)設(shè)備ID?？蛇x服務(wù)影子數(shù)據(jù)。字段名必選/可選類型參數(shù)描述必選設(shè)備的服務(wù)ID。可選可選可選設(shè)備影子版本信息字段名必選/可選類型參數(shù)描述必選設(shè)備服務(wù)的屬性列表，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型里定義，可以設(shè)置多個字段?？蛇x設(shè)備屬性數(shù)據(jù)的UTC時間（格式：上行請求示例數(shù)據(jù)格式：{}下行響應(yīng)示例數(shù)據(jù)格式：{{DB5120/T29.3—2024},},},},]}注：具體開發(fā)流程可以參考《IoT設(shè)備接入開發(fā)指南》->“腳本化開發(fā)插件”章節(jié)。DB5120/T29.3—2024附錄D請求URI示例示例D.1示例請求URI由如下部分組成。盡管請求URI包含在請求消息頭中，但大多數(shù)語言或框架都要求用戶從請求消息中單獨傳遞它，所以在此單獨強調(diào)。URI-scheme：表示用于傳輸請求的協(xié)議，當(dāng)前所有API均采用HTTPS協(xié)議。Endpoint：指定承載REST服務(wù)端點的服務(wù)器域名或IP，不同服務(wù)不同區(qū)域的Endpoint不同，用戶需要根據(jù)實際區(qū)域填寫。resource-path：資源路徑，也即API訪問路徑。從具體API的URI模塊獲取，例如“查詢產(chǎn)品”API形式為“參數(shù)名=參數(shù)取值”，例如“l(fā)imit=10”，表示查詢不超過10條數(shù)據(jù)。1)請求消息頭附加請求頭字段，如指定的URI和HTTP方法所要求的字段。例如定義消息體類型的請求頭如下公共消息頭需要添加到請求中。具體接口中專門說明。接口獲取，接口返回的響應(yīng)消息頭中“X-Subject-Token”就是需要獲取的用戶Token。添加消息頭后的請求如下所示。2)請求消息體請求消息體通常以結(jié)構(gòu)化格式發(fā)出，與請求消息頭中Content-type對應(yīng)，傳遞除請求消息頭之外的內(nèi)容。若請求消息體中參數(shù)支持中文，則中文字符必須為UTF-8編碼。每個接口的請求消息體內(nèi)容不同，也并不是每個接口都需要有請求消息體（或者說消息體為空GET、DELETE操作類型的接口就不需要消息體，消息體具體內(nèi)容需要根據(jù)具體接口而定。對于創(chuàng)建產(chǎn)品接口，用戶可以從接口的請求部分看到所需的請求參數(shù)及參數(shù)說明。將消息體加入后的請求如下所示，加粗的斜體字段需要根據(jù)實際值填寫，如：其中name為產(chǎn)品名稱，device_type為設(shè)備X-Auth-Token:********DB5120/T29.3—2024{DB5120/