DB3305-T 252-2022物聯(lián)中臺(tái)接入與數(shù)據(jù)轉(zhuǎn)發(fā)技術(shù)規(guī)范

ICS03.080.99

CCSA01

DB3305

浙江省湖州市地方標(biāo)準(zhǔn)

DB3305/T252—2022

物聯(lián)中臺(tái)接入與數(shù)據(jù)轉(zhuǎn)發(fā)技術(shù)規(guī)范

InternetofThingsPlatformAccessandDataForwardingTechnical

Specification

2022-12-7發(fā)布2022-12-9實(shí)施

湖州市市場(chǎng)監(jiān)督管理局發(fā)布

1

DB3305/T252—2022

目次

前言................................................................................II

1范圍...............................................................................1

2規(guī)范性引用文件.....................................................................1

3術(shù)語(yǔ)和定義.........................................................................1

4縮略語(yǔ).............................................................................3

5接入管理...........................................................................3

6數(shù)據(jù)轉(zhuǎn)發(fā)...........................................................................9

附錄A（資料性）公開(kāi)API使用示例.....................................................13

I

DB3305/T252—2022

前言

本標(biāo)準(zhǔn)旨在指導(dǎo)湖州市物聯(lián)中臺(tái)物聯(lián)感知體系規(guī)劃、建設(shè)及改造，夯實(shí)全域感知的基礎(chǔ)。

本標(biāo)準(zhǔn)編寫原則：遵循國(guó)家感知終端有關(guān)法律法規(guī)，保證本文檔內(nèi)容能適用于物聯(lián)中臺(tái)建設(shè)需求，

規(guī)范終端接入、數(shù)據(jù)轉(zhuǎn)發(fā)以及安全等相關(guān)活動(dòng)。

本文件由湖州市大數(shù)據(jù)發(fā)展管理局提出并歸口。

本文件起草單位：湖州市大數(shù)據(jù)發(fā)展管理局、湖州市數(shù)據(jù)服務(wù)中心、湖州市吳興區(qū)大數(shù)據(jù)服務(wù)中心、

湖州市南潯區(qū)大數(shù)據(jù)服務(wù)中心、德清縣大數(shù)據(jù)發(fā)展管理局、長(zhǎng)興縣大數(shù)據(jù)發(fā)展管理局、安吉縣大數(shù)據(jù)發(fā)

展管理局、湖州南太湖產(chǎn)業(yè)集聚區(qū)管理委員會(huì)、湖州經(jīng)濟(jì)技術(shù)開(kāi)發(fā)區(qū)管理委員會(huì)、湖州市標(biāo)準(zhǔn)化研究院、

中移物聯(lián)網(wǎng)有限公司、中國(guó)移動(dòng)通信集團(tuán)浙江有限公司湖州分公司。

本文件主要起草人：蔡豐、笪猛霄、馬紅斌、陳瑋萍、許彪、范俊、梅勇、張加林、姚朔舟、馮凌、

張建勇、楊志杰、茅恒達(dá)、陸一鳴、秦琪波、呂一品、潘健、沈一雄、錢建國(guó)、盧浩、朱陽(yáng)、敬威、朱

云杰、鄭京天、王碩。

II

DB3305/T252—2022

物聯(lián)中臺(tái)接入與數(shù)據(jù)轉(zhuǎn)發(fā)技術(shù)規(guī)范

1范圍

本文件規(guī)定了物聯(lián)中臺(tái)的接入和數(shù)據(jù)轉(zhuǎn)發(fā)規(guī)范等內(nèi)容。

本文件適用于指導(dǎo)感知終端硬件開(kāi)發(fā)者、物聯(lián)網(wǎng)應(yīng)用開(kāi)發(fā)者用戶使用物聯(lián)中臺(tái)進(jìn)行設(shè)備接入和數(shù)據(jù)

轉(zhuǎn)發(fā)工作。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T33745-2017物聯(lián)網(wǎng)術(shù)語(yǔ)

GB/T36951-2018信息安全技術(shù)物聯(lián)網(wǎng)感知終端應(yīng)用安全技術(shù)要求

GB/T38637.2-2020物聯(lián)網(wǎng)感知控制設(shè)備接入第2部分：數(shù)據(jù)管理要求

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

物聯(lián)中臺(tái)InternetofThingsPlatform

物聯(lián)中臺(tái)是一個(gè)集成了設(shè)備管理、消息訂閱等能力的一體化軟件系統(tǒng)。它向下實(shí)現(xiàn)各類感知終端統(tǒng)

一接入和集中管理，向上面向第三方應(yīng)用系統(tǒng)提供數(shù)據(jù)推送以及API接口服務(wù)，實(shí)現(xiàn)物聯(lián)數(shù)據(jù)統(tǒng)一標(biāo)準(zhǔn)

匯聚以及多方共享。

3.2

感知數(shù)據(jù)sensingdata

通過(guò)數(shù)據(jù)采集獲取的原始數(shù)據(jù)或在此基礎(chǔ)上進(jìn)行加工處理的表征對(duì)象信息的數(shù)據(jù)統(tǒng)稱。

[GB/T38637.2-2020，定義3.1]

3.3

感知終端sensingterminal

能對(duì)物或環(huán)境進(jìn)行信息采集和/或執(zhí)行操作，并能聯(lián)網(wǎng)進(jìn)行通信的裝置。

[GB/T36951-2018，定義3.1.2]

3.4

物聯(lián)網(wǎng)應(yīng)用IoTService

1

DB3305/T252—2022

物聯(lián)網(wǎng)在具體場(chǎng)景中的使用實(shí)例，向用戶提供物聯(lián)網(wǎng)服務(wù)的集合。

[GB/T33745-2017物聯(lián)網(wǎng)術(shù)語(yǔ)]

3.5

產(chǎn)品product

產(chǎn)品是一組具有相同功能定義的設(shè)備集合。

3.6

設(shè)備device

歸屬于某一個(gè)產(chǎn)品下，是真實(shí)設(shè)備在物聯(lián)中臺(tái)的映射，用于和真實(shí)設(shè)備通過(guò)連接報(bào)文建立連接關(guān)系，

是物聯(lián)中臺(tái)資源分配的最小單位。

3.7

物模型physicalmodel

物模型是對(duì)設(shè)備的數(shù)字化抽象描述，從屬性、服務(wù)和事件三個(gè)維度分別描述該型號(hào)設(shè)備是什么，能

做什么，能對(duì)外提供哪些服務(wù)。

3.8

功能點(diǎn)functionpoints

用于描述物模型的具體指標(biāo)、參數(shù)類型，功能點(diǎn)包括標(biāo)準(zhǔn)功能點(diǎn)、自定義功能點(diǎn)功及系統(tǒng)功能點(diǎn)。

例如冰箱，功能點(diǎn)中設(shè)備功能可以包括開(kāi)關(guān)、速凍模式、速冷模式、溫度設(shè)定、童鎖、電量統(tǒng)計(jì)、故障

告警等參數(shù)；系統(tǒng)功能可以包括信號(hào)強(qiáng)度、經(jīng)緯度、版本等參數(shù)。

3.9

協(xié)議適配protocoladaptation

是指實(shí)現(xiàn)對(duì)通信協(xié)議（如MQTT、LwM2M、CoAP等）的連接、鑒權(quán)、路由、應(yīng)答、解析、管理等功能

的過(guò)程。

3.10

心跳包heartbeatpacket

平臺(tái)與物聯(lián)感知終端之間通過(guò)周期性發(fā)送信息，判斷物聯(lián)感知終端的健康狀況，判斷對(duì)方是否“存

活”。

3.11

邊緣物聯(lián)網(wǎng)平臺(tái)edgeIoTplatform

是指在邊緣側(cè)提供應(yīng)用、物聯(lián)網(wǎng)設(shè)備管理、工業(yè)終端協(xié)議適配、云邊協(xié)同、海量數(shù)據(jù)處理等功能的

物聯(lián)網(wǎng)平臺(tái)。

3.12

應(yīng)用開(kāi)發(fā)者applicationdevelopers

2

DB3305/T252—2022

指利用物聯(lián)中臺(tái)提供能力把已接入平臺(tái)設(shè)備進(jìn)行集中管理，并將設(shè)備數(shù)據(jù)轉(zhuǎn)發(fā)至第三方平臺(tái)以支撐

上層物聯(lián)網(wǎng)應(yīng)用開(kāi)發(fā)的人員。

3.13

第三方平臺(tái)thethird-partyplatform

承載具體物聯(lián)網(wǎng)應(yīng)用并提供服務(wù)的第三方系統(tǒng)。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

API：應(yīng)用程序接口（ApplicationProgrammingInterface）

CoAP：受約束的應(yīng)用協(xié)議（ConstrainedApplicationProtocol）

HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）

IETF：國(guó)際互聯(lián)網(wǎng)工程任務(wù)組（TheInternetEngineeringTaskForce）

JSON：對(duì)象簡(jiǎn)譜（JavaScriptObjectNotation）

LwM2M：輕量級(jí)M2M協(xié)議(LightweightMachine-to-Machine)

MQTT：消息隊(duì)列遙測(cè)傳輸（MessageQueueTelemetryTransport）

OMA：開(kāi)放移動(dòng)聯(lián)盟（OpenMobileAlliance）

REST：表述性狀態(tài)傳遞（RepresentationalStateTransfer）

SDK：軟件開(kāi)發(fā)工具包（SoftwareDevelopmentKit）

UDP：用戶數(shù)據(jù)包協(xié)議（UserDatagramProtocol）

URI：統(tǒng)一資源標(biāo)識(shí)符（UniformResourceIdentifier）

5接入管理

5.1總體接入框架

5.1.1總體接入框架應(yīng)包含感知層（與總體技術(shù)要求）、網(wǎng)絡(luò)層、平臺(tái)層、應(yīng)用層等，四層架構(gòu)如圖

1所示。

3

DB3305/T252—2022

圖1總體接入框架圖

5.1.2感知層主要包括生態(tài)環(huán)境、農(nóng)村農(nóng)業(yè)、交通運(yùn)輸、市政、管廊等場(chǎng)景的感知終端。

5.1.3網(wǎng)絡(luò)層主要包括實(shí)現(xiàn)感知層到平臺(tái)層數(shù)據(jù)傳輸?shù)纳逃脗鬏斁W(wǎng)絡(luò)或?qū)＞W(wǎng)。

5.1.4平臺(tái)層是物聯(lián)中臺(tái)，提供感知終端協(xié)議適配、設(shè)備管理、數(shù)據(jù)轉(zhuǎn)發(fā)、運(yùn)維監(jiān)控等功能。

5.1.5應(yīng)用層主要提供各種物聯(lián)網(wǎng)應(yīng)用服務(wù)。應(yīng)用層宜基于平臺(tái)層數(shù)據(jù)轉(zhuǎn)發(fā)等服務(wù)設(shè)計(jì)、構(gòu)建物聯(lián)網(wǎng)

應(yīng)用。

5.2通用接入要求

5.2.1網(wǎng)絡(luò)要求

設(shè)備直連、網(wǎng)關(guān)接入、第三方平臺(tái)以及邊緣物聯(lián)網(wǎng)平臺(tái)總計(jì)四種接入方式均應(yīng)該和互聯(lián)網(wǎng)打通。

5.2.2物模型要求

設(shè)備接入物聯(lián)中臺(tái)應(yīng)在物聯(lián)中臺(tái)上對(duì)產(chǎn)品設(shè)置物模型，用于實(shí)現(xiàn)不同設(shè)備能夠以統(tǒng)一的物模型標(biāo)準(zhǔn)

對(duì)接應(yīng)用平臺(tái)，不同應(yīng)用之間能夠以統(tǒng)一物模型標(biāo)準(zhǔn)進(jìn)行數(shù)據(jù)互通。

5.2.3設(shè)備健壯性要求

設(shè)備健壯性要求包括：

——主動(dòng)上報(bào)心跳包功能；

——主動(dòng)離線斷開(kāi)連接功能；

——異常離線檢測(cè)功能；

——異常離線重連機(jī)制；

——上報(bào)離線原因的功能；

——命令回復(fù)機(jī)制；

——上報(bào)固件版本信息功能；

——上報(bào)設(shè)備型號(hào)功能；

——上報(bào)網(wǎng)絡(luò)信號(hào)強(qiáng)度功能（對(duì)于用無(wú)線方式接入的設(shè)備）。

4

DB3305/T252—2022

5.3接入流程

5.3.1概述

各類感知終端接入物聯(lián)中臺(tái)總體上應(yīng)遵循以下流程，見(jiàn)圖2：

圖2接入流程

5.3.2創(chuàng)建產(chǎn)品

設(shè)備接入的第一步是創(chuàng)建產(chǎn)品。產(chǎn)品為同種設(shè)備類型，產(chǎn)品下的設(shè)備擁有相同的物模型（功能）、

數(shù)據(jù)格式。

5.3.3設(shè)置物模型

設(shè)置產(chǎn)品下設(shè)備的功能點(diǎn)，統(tǒng)一物模型后可以使設(shè)備與物聯(lián)中臺(tái)間的數(shù)據(jù)格式標(biāo)準(zhǔn)化，簡(jiǎn)化設(shè)備和

應(yīng)用的開(kāi)發(fā)。

5.3.4添加設(shè)備

物理設(shè)備要連接到平臺(tái)，應(yīng)先在物聯(lián)中臺(tái)創(chuàng)建設(shè)備，并獲取連接到物聯(lián)中臺(tái)的鑒權(quán)信息。

5.3.5協(xié)議適配

按照不同的接入方式應(yīng)通過(guò)協(xié)議適配開(kāi)發(fā)或配置打通感知終端和物聯(lián)中臺(tái)的數(shù)據(jù)通道。

設(shè)備直連

5

DB3305/T252—2022

.1概述

設(shè)備應(yīng)通過(guò)有線傳輸方式或無(wú)線傳輸方式（蜂窩網(wǎng)、wifi等）直接連接到物聯(lián)中臺(tái)。

——感知終端功能單一，分布分散，獨(dú)立使用；

——對(duì)時(shí)延要求不高的業(yè)務(wù)應(yīng)用場(chǎng)景；

——已建項(xiàng)目相關(guān)感知終端已采用直連方式接入業(yè)務(wù)平臺(tái)的情況。

圖3設(shè)備直連接入示意圖

.2協(xié)議要求

在正常通信階段，采用設(shè)備直連接入方式的感知終端應(yīng)使用下列方式中的至少一種方式，完成感知

終端與物聯(lián)中臺(tái)的數(shù)據(jù)交換：

——基于長(zhǎng)連接的MQTT實(shí)時(shí)通信；

——基于無(wú)連接的CoAP實(shí)時(shí)通信；

——基于無(wú)連接的LwM2M實(shí)時(shí)通信。

.2.1MQTT協(xié)議接入

.2.1.1物聯(lián)中臺(tái)應(yīng)支持終端廠商（開(kāi)發(fā)者）使用標(biāo)準(zhǔn)MQTT協(xié)議接入設(shè)備。

.2.1.2MQTT協(xié)議通過(guò)交換預(yù)定義的MQTT控制報(bào)文來(lái)通信，MQTT控制報(bào)文由固定報(bào)頭、可

變報(bào)頭及有效載荷三部分組成。

.2.2CoAP協(xié)議接入

.2.2.1物聯(lián)中臺(tái)應(yīng)支持終端廠商（開(kāi)發(fā)者）使用標(biāo)準(zhǔn)CoAP協(xié)議接入設(shè)備。

.2.2.2CoAP協(xié)議是IETF提出的一種面向網(wǎng)絡(luò)的協(xié)議，采用了與HTTPS類似的特征，核心內(nèi)

容為資源抽象、REST式交互以及可擴(kuò)展的頭選項(xiàng)等。

.2.3LwM2M協(xié)議接入

.2.3.1物聯(lián)中臺(tái)應(yīng)支持終端廠商（開(kāi)發(fā)者）使用標(biāo)準(zhǔn)LwM2M協(xié)議接入設(shè)備。

.2.3.2LwM2M是OMA組織制定的輕量化的M2M協(xié)議。LwM2M定義了三個(gè)邏輯實(shí)體:

——LwM2MServer服務(wù)器；

6

DB3305/T252—2022

——LwM2MClient客戶端，負(fù)責(zé)執(zhí)行服務(wù)器的命令和上報(bào)執(zhí)行結(jié)果；

——LwM2M引導(dǎo)服務(wù)器BootstrapServer，負(fù)責(zé)配置LwM2M客戶端。

.2.3.3在三個(gè)邏輯實(shí)體之間有4個(gè)邏輯接口：

——DeviceDiscoveryandRegistration：客戶端注冊(cè)到服務(wù)器并通知服務(wù)器客戶端所支持的能

力；

——Bootstrap：BootstrapServer配置Client；

——DeviceManagementandServiceEnablement：指令發(fā)送和接收；

——InformationReporting：上報(bào)其資源信息。

網(wǎng)關(guān)接入

對(duì)于感知終端功能相對(duì)復(fù)雜，分布較集中，設(shè)備自組網(wǎng)的業(yè)務(wù)應(yīng)用場(chǎng)景或已建項(xiàng)目相關(guān)感知終端已

使用物聯(lián)網(wǎng)感知層網(wǎng)關(guān)（智能網(wǎng)關(guān)、網(wǎng)絡(luò)控制器等）接入業(yè)務(wù)平臺(tái)的情況，要求相關(guān)物聯(lián)網(wǎng)感知終端在

本地接入物聯(lián)網(wǎng)感知層網(wǎng)關(guān)，物聯(lián)網(wǎng)感知層網(wǎng)關(guān)應(yīng)通過(guò)有線傳輸方式或無(wú)線傳輸方式（無(wú)線蜂窩網(wǎng)、

LoRa、wifi等）接入物聯(lián)中臺(tái)，見(jiàn)圖4。

圖4網(wǎng)關(guān)接入示意圖

平臺(tái)接入

.1對(duì)于已建項(xiàng)目中涉及感知終端的已建系統(tǒng)因設(shè)備、網(wǎng)關(guān)不適于二次改造或有特殊行業(yè)要求

的物聯(lián)終端（如應(yīng)急安全場(chǎng)景等），應(yīng)采用平臺(tái)接入方式同步物聯(lián)數(shù)據(jù)至物聯(lián)中臺(tái)。

.2基于物聯(lián)中臺(tái)企業(yè)融合模塊，通過(guò)HTTPS的方式對(duì)第三方平臺(tái)的數(shù)據(jù)進(jìn)行抽取、分析，然

后將處理后的數(shù)據(jù)上報(bào)給物聯(lián)中臺(tái)，最終實(shí)現(xiàn)設(shè)備數(shù)據(jù)的平滑接入，見(jiàn)圖5。

7

DB3305/T252—2022

圖5平臺(tái)接入示意圖

.3采用平臺(tái)接入的方式，對(duì)接的數(shù)據(jù)主要為設(shè)備的功能點(diǎn)消息。

.4第三方平臺(tái)與協(xié)議適配服務(wù)通過(guò)HTTPS協(xié)議進(jìn)行交互。交互的形式為兩種：

a）第三方平臺(tái)提供API服務(wù)，企業(yè)融合模塊通過(guò)定時(shí)器定期調(diào)用其API，獲取設(shè)備數(shù)據(jù)；

b）企業(yè)融合模塊提供API服務(wù)，第三方平臺(tái)定期將設(shè)備數(shù)據(jù)通過(guò)API的形式上報(bào)到協(xié)議適配服務(wù)。

c）在實(shí)際操作中，只需選用任意一種對(duì)接方式即可。

.5企業(yè)融合模塊從第三方平臺(tái)獲取的是原始的JSON消息，應(yīng)轉(zhuǎn)換為物聯(lián)中臺(tái)定義的物模型格

式。

.6企業(yè)融合模塊根據(jù)收到消息的種類，調(diào)用提供的不同API，對(duì)消息進(jìn)行處理。最終調(diào)用內(nèi)

部的MQTT客戶端，將消息通過(guò)MQTT協(xié)議上傳到物聯(lián)中臺(tái)。

.7在平臺(tái)對(duì)平臺(tái)方案中，企業(yè)融合模塊與物聯(lián)中臺(tái)為單向通信。方向：第三方平臺(tái)—>企業(yè)融

合模塊—>物聯(lián)中臺(tái)。

邊緣物聯(lián)網(wǎng)平臺(tái)接入

對(duì)于網(wǎng)絡(luò)較為封閉，感知終端專業(yè)化程度高或安全要求等級(jí)較高，有其它需要在本地使用感知數(shù)據(jù)

的業(yè)務(wù)應(yīng)用平臺(tái)的場(chǎng)景，或在本地有大流量、低時(shí)延、本地自治的應(yīng)用場(chǎng)景，如視頻監(jiān)控、圖像識(shí)別、

即時(shí)應(yīng)急處理等，要求部署邊緣物聯(lián)網(wǎng)平臺(tái)，在本地進(jìn)行感知終端接入，提供物聯(lián)網(wǎng)相關(guān)能力服務(wù)，同

時(shí)與物聯(lián)中臺(tái)對(duì)接進(jìn)行通訊，見(jiàn)圖6。

8

DB3305/T252—2022

圖6邊緣物聯(lián)網(wǎng)平臺(tái)接入示意圖

5.3.6設(shè)備調(diào)試

應(yīng)通過(guò)設(shè)備調(diào)試功能進(jìn)行數(shù)據(jù)交互調(diào)試，查看設(shè)備實(shí)時(shí)日志，進(jìn)行設(shè)備功能數(shù)據(jù)驗(yàn)證。

6數(shù)據(jù)轉(zhuǎn)發(fā)

6.1轉(zhuǎn)發(fā)方式

6.1.1物聯(lián)中臺(tái)應(yīng)支持應(yīng)用開(kāi)發(fā)者將感知終端數(shù)據(jù)通過(guò)平臺(tái)數(shù)據(jù)推送、主動(dòng)調(diào)取公開(kāi)API等功能將數(shù)

據(jù)轉(zhuǎn)發(fā)給經(jīng)過(guò)授權(quán)且對(duì)應(yīng)的感知終端應(yīng)用。

6.1.2平臺(tái)數(shù)據(jù)轉(zhuǎn)發(fā)應(yīng)提供以下兩種方式：

1）數(shù)據(jù)推送（HTTPS）。HTTPS推送用于實(shí)現(xiàn)物聯(lián)中臺(tái)與第三方平臺(tái)之間的單向數(shù)據(jù)通信。物聯(lián)中

臺(tái)作為客戶端，通過(guò)HTTPS請(qǐng)求方式，將平臺(tái)下設(shè)備數(shù)據(jù)推送給第三方平臺(tái)應(yīng)用服務(wù)器。

2）主動(dòng)調(diào)?。ü_(kāi)API）。物聯(lián)中臺(tái)提供公開(kāi)API，用戶通過(guò)對(duì)應(yīng)密鑰鑒權(quán)后，能調(diào)取功能豐富的

API，能實(shí)現(xiàn)消息推送，消息分發(fā)等功能。

6.2數(shù)據(jù)推送標(biāo)準(zhǔn)（HTTPS）

6.2.1概述

數(shù)據(jù)推送服務(wù)（HTTPS）應(yīng)包括實(shí)例創(chuàng)建、實(shí)例驗(yàn)證、規(guī)則配置、消息推送4個(gè)步驟。業(yè)務(wù)流程如圖

7所示:

9

DB3305/T252—2022

圖7數(shù)據(jù)推送服務(wù)使用流程

6.2.2實(shí)例創(chuàng)建

每個(gè)實(shí)例對(duì)應(yīng)一個(gè)HTTPS的推送配置實(shí)例。應(yīng)用開(kāi)發(fā)者需要在物聯(lián)中臺(tái)創(chuàng)建實(shí)例，需要配置參數(shù)包

括：推送地址，Token，消息加密方式。

6.2.3實(shí)例驗(yàn)證

物聯(lián)中臺(tái)服務(wù)器應(yīng)向配置的服務(wù)器地址發(fā)送HTTPSGET請(qǐng)求，進(jìn)行地址有效性驗(yàn)證，請(qǐng)求形

式示例如下：

https://url?msg=xxx&nonce=xxx&signature=xxx

第三方平臺(tái)應(yīng)用服務(wù)器收到請(qǐng)求后，應(yīng)通過(guò)signature參數(shù)字段對(duì)請(qǐng)求進(jìn)行校驗(yàn)。若確認(rèn)此

次GET請(qǐng)求來(lái)自物聯(lián)中臺(tái)，需在響應(yīng)中原樣返回msg參數(shù)，實(shí)例驗(yàn)證才能通過(guò)，否則驗(yàn)證失敗，實(shí)例配

置不生效。

6.2.4規(guī)則配置

應(yīng)用開(kāi)發(fā)者應(yīng)在平臺(tái)規(guī)則引擎模塊自定義規(guī)則，對(duì)項(xiàng)目下設(shè)備數(shù)據(jù)進(jìn)行篩選過(guò)濾，以實(shí)現(xiàn)數(shù)據(jù)轉(zhuǎn)發(fā)

至物聯(lián)中臺(tái)通信組件。

6.2.5消息推送

物聯(lián)中臺(tái)應(yīng)支持設(shè)備生命周期、設(shè)備物模型等數(shù)據(jù)推送。當(dāng)需推送數(shù)據(jù)通過(guò)平臺(tái)合法性校驗(yàn)

入庫(kù)以后基于數(shù)據(jù)推送服務(wù)以JSON形式置于HTTPS請(qǐng)求中的body部分并推送給第三方平臺(tái)應(yīng)用服務(wù)

器。

10

DB3305/T252—2022

圖8推送數(shù)據(jù)流轉(zhuǎn)流程

配置推送實(shí)例時(shí)，如果選擇消息推送方式為安全模式，則平臺(tái)應(yīng)對(duì)消息msg進(jìn)行加密處理，

應(yīng)用服務(wù)器收到數(shù)據(jù)時(shí)，需通過(guò)生成密鑰進(jìn)行解密操作。

6.3公開(kāi)API接口標(biāo)準(zhǔn)

6.3.1API調(diào)用說(shuō)明

物聯(lián)中臺(tái)應(yīng)提供項(xiàng)目、設(shè)備、服務(wù)等云端API，配合API接口文檔幫助應(yīng)用開(kāi)發(fā)者快速開(kāi)發(fā)應(yīng)用，滿

足場(chǎng)景業(yè)務(wù)需求。

6.3.2公共請(qǐng)求說(shuō)明

API接口請(qǐng)求參數(shù)應(yīng)包括公共參數(shù)和自定義業(yè)務(wù)參數(shù)兩部分。公共請(qǐng)求參數(shù)是調(diào)用每個(gè)API時(shí)都需要

攜帶的請(qǐng)求參數(shù),包括服務(wù)命名空間、接口名稱、版本信息。自定義業(yè)務(wù)參數(shù)由各接口定義，根據(jù)調(diào)用

方法不同，需要將參數(shù)攜帶至請(qǐng)求路徑或者請(qǐng)求體中。API接口公共參數(shù)調(diào)用如下所示:

https://xxxxxx/{namespace}?action=xxxx&version=1

6.3.3API鑒權(quán)

物聯(lián)中臺(tái)應(yīng)對(duì)API調(diào)用方進(jìn)行資源權(quán)限校驗(yàn)，使用API時(shí)，需要在請(qǐng)求Header中攜帶統(tǒng)一的安全鑒權(quán)

信息。

6.3.4安全鑒權(quán)機(jī)制

11

DB3305/T252—2022

安全鑒權(quán)authorization由多個(gè)參數(shù)構(gòu)成，每個(gè)參數(shù)均應(yīng)采用key=value的形式表示，并用

&作為分隔符：

authorization:

version=2020-05-29&res=userid%2F38055&et=1623982416&method=sha1&sign=S04GcvafYIjtAMHJthkG

PevbNwE%3D

sign的生成算法為:

sign=base64(hmac_<method>(base64decode(AccessKey),utf-8(StringForSignature)))

AccessKey為物聯(lián)中臺(tái)分配的訪問(wèn)密鑰（用戶訪問(wèn)權(quán)限頁(yè)面查看），如果訪問(wèn)資源以主用戶形

式訪問(wèn),使用主用戶的AccessKey，如果訪問(wèn)資源以項(xiàng)目群組方式訪問(wèn)，使用群組的AccessKey，且只

能對(duì)群組內(nèi)設(shè)備進(jìn)行操作。

AccessKey參與計(jì)算前應(yīng)先進(jìn)行base64decode操作。

用于計(jì)算簽名的字符串StringForSignature按照et、method、resource、version的順序，

以"\n"作為分隔符進(jìn)行排列，如下所示：

StringForSignature=et+"\n"+method+"\n"+res+"\n"+version

12

DB3305/T252—2022

附錄A

（資料性）

公開(kāi)API使用示例

A.1請(qǐng)求示例

請(qǐng)求示例如下：

GET/common?action=QueryDeviceDetail&version=1&product_id=lsibd9&device_name=no001

A.2響應(yīng)示例

A.2.1響應(yīng)參數(shù)說(shuō)明

請(qǐng)求響應(yīng)參數(shù)說(shuō)明見(jiàn)表A.1。

表A.1響應(yīng)參數(shù)說(shuō)明

序號(hào)參數(shù)類型描述

1requestIdstring請(qǐng)求ID，調(diào)用API時(shí)由平臺(tái)生成唯一請(qǐng)求標(biāo)識(shí)

2codestring調(diào)用失敗時(shí)，返回的錯(cuò)誤碼

3msgstring調(diào)用失敗時(shí)，返回的錯(cuò)誤信息

4successboolean接口是否調(diào)用成功

5dataobject調(diào)用成功時(shí)，返回的業(yè)務(wù)數(shù)據(jù)（接口無(wú)業(yè)務(wù)數(shù)據(jù)返回，值為null）

A.2.2成功響應(yīng)

成功響應(yīng)示例如下：

{

"requestId":"8906582E6722409AA6C40E7863B733A5",

"success":true,

"data":{

status:1

}

}

A.2.3失敗響應(yīng)

失敗響應(yīng)示例：

{

"requestId":"8906582E6722409AA6C40E7863B733A5",

"code":"iot.application.deviceNotFound",

"msg":"devicedoesnotexist",

"success":false

}

13

DB3305/T252—2022

目次

前言................................................................................II

1范圍...............................................................................1

2規(guī)范性引用文件.....................................................................1

3術(shù)語(yǔ)和定義.........................................................................1

4縮略語(yǔ).............................................................................3

5接入管理...........................................................................3

6數(shù)據(jù)轉(zhuǎn)發(fā)...........................................................................9

附錄A（資料性）公開(kāi)API使用示例.....................................................13