DB36T 1845-2023 农村人居环境长效管护平台数据交换规范

ICS35.100.20CCSL72DB36Dataexchangespecificationforlong-termmanagementandprotectionplatformofrurallivingenvironm江西省市场监督管理局发布IDB36/T1845—2023前言 2规范性引用文件 3术语和定义 4数据交换流程 5接口要求 6接口设计 7设备上报频次 8设备离线存储、断点续传 附录A（资料性）接口设计标准 5附录B（资料性）返回接口示例 22DB36/T1845—2023本文件按照GB/T1.1－2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由江西省农业农村厅提出并归口。本文件起草单位：江西省农业技术推广中心、江西电信信息产业有限公司、江西省数字乡村研究院。本文件主要起草人：陈勋洪、钟志宏、杨眉、黄建昌、张敏、徐军亮、姜凯文、邓碧岩、官文峰。DB36/T1845—2023当前农村人居环境长效管护平台接入的物联网监测平台较多，涉及设备品牌繁多，各厂家平台及设备数据标准不一，从而导致对接成本、维护成本、运营成本的增加，制约了平台的快速建设推广。为有效加强全省农村人居环境长效管护平台建设的统一规划、统一管理、协调运行和维护服务，建立健全全省农村人居环境长效管护平台的数据交换标准，推动农村人居环境长效管护平台的建设运营有序发展，提升各级政府及其部门的农村人居环境治理水平，现根据国家、地方相关文件要求和标准，结合我省农村人居环境治理现状和发展要求，制定本文件。1DB36/T1845—2023农村人居环境长效管护平台数据交换规范本文件规定了农村人居环境长效管护平台接口数据交换的相关术语和定义、数据交换流程、接口要求、接口设计、设备数据上报频次、设备数据断点续传。本文件适用于农村人居环境长效管护平台接口设计。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T28168信息技术中间件消息中间件技术规范GB/T33745—2017物联网术语GB/T36478.1—2018物联网信息交换和共享第1部分：总体架构3术语和定义GB/T33745—2017、GB/T36478.1—2018界定的以及下列术语和定义适用于本文件。3.1农村人居环境长效管护平台rurallivingenvironmentlong-termmanagementplatform采用物联网、云计算、大数据、AI等新一代信息技术建设的农村人居环境长效管护信息平台。包含物联云判、管护调度、乡村大脑、四大治理、“万村码上通”小程序等模块，具有针对农村人居环境事件“投诉、整改、反馈、监督”和人、车、事、物、情“一图统揽、一网统调”等功能。3.2数据采集终端dataacquisitionterminal用于监测农村人居环境的设备，如垃圾桶满溢监测设备、人员作业跟踪定位卡牌、厕所气味探测设备、污水水质检测设备、车载跟踪定位设备。3.3物联网监测数据共享模块/系统IoTmonitoringdatasharingmodule/system农村人居环境长效管护平台中采集物联网动态监测数据并提供数据共享服务的模块/系统。4数据交换流程2DB36/T1845—2023依据GB/T36478.1—2018中的规定，通过数据接口方式，数据提供方通过物联网系统将交换和共享的数据导入到对应的模块/系统；数据需求方从物联网相应模块/系统获取物联网数据，数据交换流程如图1所示。图1数据交换示意图5接口要求5.1约定5.1.1数据交换基于RESTfulAPI，采用标准JSON数据格式。5.1.2为便于提供方和需求方统一调用数据，接口方法和参数宜采用英文单词命名。5.2协议使用HTTPS协议。5.3消息格式5.3.1请求头不同的接口应具有同一请求头，请求头的名称和含义描述应符合表1。3DB36/T1845—2023表1请求头5.3.2请求参数不同接口功能，其请求参数存在差异。请求参数格式示例见表2。表2请求参数格式示例————————5.4返回数据格式返回数据应包含：返回状态码、返回状态信息、具体数据。以json格式为例。{"code":"0","msg":"success","data":{//json格式的具体数据}6接口设计6.1基本要求接口设计应满足如下要求：——接口地址：http://服务器地址:端口号/api/open/接口方法名。——接口协议：WebService。——编码方式：UTF-8。——交换格式：JSON。接口设计参考附录A，接口返回示例见附录B。4DB36/T1845—20236.2返回状态码code接口返回状态码见表3。表3返回状态码code及描述07设备上报频次设备主要数据上报频次如下：——智能垃圾桶：1条/6小时。——水质监测设备：1条/6小时。——气味探测器：1条/6小时。——车载：1条/分钟。——卡牌：1条/5分钟。——环境探测器：1条/2小时。8设备离线存储、断点续传设备应具备在网络不佳时本地存储数据，待网络通畅时上传未上报数据的功能。消息机制应符合GB/T28168的规定。5DB36/T1845—2023接口设计标准A.1服务调用步骤A.1.1数据需求方将授权Id（appId）和密钥（appSecret）进行SHA-2加密传输，数据提供方在SHA-2加密算法的基础上进行了加盐操作。盐是随机生成的字符串。我们将盐与原始数据连接在一起，然后将连接后的字符串加密处理返回token令牌。后续在调用设备管理和设备数据管理相关接口时需使用该令牌。获取令牌接口参考A.2.1。A.1.2数据提供方数据提供方应满足如下要求：——获取请求数据进行相关业务处理；——根据数据需求方的请求输出数据；——返回调用结果给数据需求方。A.2身份认证获取令牌接口应满足如下要求：——接口方法：getToken；——接口路径：api/open/oauth/；——请求方式：POST。请求参数见表A.1。表A.1getToken是是返回示例见附录B.1。A.3设备管理A.3.1产品列表获取农村人居环境长效管护平台标准物联网产品，接口要求如下：——接口方法：getProductList；——接口路径：api/open/product/；——请求方式：POST。参数见表A.2。表A.2getProductList6DB36/T1845—2023是否productProtocol否productId是返回示例见附录B.2。A.3.2设备列表获取农村人居环境长效管护平台设备列表的接口要求如下：——接口方法：getDeviceList；——接口路径：api/open/device/；——请求方式：POST。请求参数见表A.3。表A.3getDeviceList是netStatus否否productId是是区域code（依据中国行政区域编码划分规则）返回示例见附录B.3。A.3.3新建产品添加产品（产品为设备直连+非NB网关协议）的接口要求如下：——接口方法：createProduct；——接口路径：api/open/product/；——请求方式：POST。请求参数见表A.4。7DB36/T1845—2023表A.4createProduct参数名必选类型说明token是String通信证key请求body（数据类型application/json;charset=utf-8）{"accessType":1,"authType":0,"dataEncryption":0,"deviceModel":"string","encryptionType":0,"endpointFormat":0,"lwm2mEdrxTime":null,"manufacturerId":"string","networkType":0,"nodeType":1,"payloadFormat":0,"powerModel":0,"productDesc":"string","productName":"string","productProtocol":0,"productType":"string","secondaryType":"string","thirdType":"string","tupIsThrough":0,"tupDeviceModel":"string"}描述：productName：产品名称（必填）：产品名称最多64个字符，产品名称必须包含数字或字母或汉字，产品名称不能重复productType：产品分类（必填）secondaryType：二级分类（必填）thirdType：三级分类（必填）nodeType：节点类型（必填）：1.设备，2.网关accessType：接入类型（必填）:1.设备直连，2.网关接入，3.南向云接入（只支持1）networkType：网络类型（必填）:1.WIFI,2.移动蜂窝数据3.NB-IoT,4.以太网,5.蓝牙,6.ZigBee（只支持1/2/3/4）productProtocol：产品协议（必填）：只支持1.T-LINK协议2.MQTT协议3.LWM2M协议5.HTTP协议6.JT/T8087.TCP协议10.网关MQTT协议authType：认证方式1:特征串认证,2:SM9认证,3:证书认证,4:IMEI认证，5:SIMID认证，6:SM2认证，7:IPV6标识认证payloadFormat：消息格式1:json，2:紧凑二进制8DB36/T1845—2023dataEncryption：数据加密方式1:sm1,2:sm2,3:sm4,4:dtls,5:明文（只支持MQTT/LWM2M）encryptionType：安全类型(只支持MQTT,TCP协议)0:一机一密，1:一型一密tupIsThrough：是否透传：0.透传，1不透传（JT/T808，tcp协议，只有透传，消息格式必须只能传null）deviceModel：JT/T808协议设备型号manufacturerId：JT/T808协议制造商IDendpointFormat:Endpoint格式（LWM2M协议必填）:1.IMEI2.URN:IMEI:###############3.URN:IMEI-IMSI:###############-###############4.URN:IMEI+SM9powerModel：省电模式（LWM2M协议必填）：1.PSM2.DRX3.eDRXlwm2mEdrxTime:eDRX模式时间窗(LWM2M协议,当省电模式为3时,必填):20～10485.76间的值,精确到小数点后两位productDesc：产品描述（选填）：产品描述最多100个字符tupDeviceModel:设备型号，选填，设备直连并且非JT/T808协议产品必填返回示例见附录B.4。A.3.4删除产品删除产品数据，如果产品下有设备数据，则无法删除产品。删除产品的接口要求如下：——接口方法：deleteProduct；——接口路径：api/open/product/；——请求方式：DELETE。请求参数见表A.5。表A.5deleteProduct是是productId是是返回示例见附录B.5A.3.5更新产品更新产品数据的接口要求如下：——接口方法：updateProduct；——接口路径：api/open/product/；——请求方式：PUT。请求参数见表A.6。9DB36/T1845—2023表A.6updateProduct参数名必选类型说明token是String通信证keygridCode是String区域code(依据中国行政区域编码划分规则）请求body（数据类型application/json;charset=utf-8）{"endpointFormat":null,"powerModel":null,"productDesc":"string","productId":0,"productName":"string","lwm2mEdrxTime":null}描述：productId:产品ID，必填productName：产品名称，产品名称租户内不能重复，必填productDesc：产品描述，选填endpointFormat：endpoint类型（Lwm2m协议必填）1.IMEI2.URN:IMEI:###############3.URN:IMEI-IMSI:###############-###############4.URN:IMEI+SM9注：认证方式为SM9认证时，endpoint类型为4认证方式为IMEI认证、sm2认证时，endpoint类型为1、2、3powerModel：省电模式（Lwm2m协议必填）1.PSM2.DRX3.eDRXlwm2mEdrxTime：eDRX模式时间窗（LWM2M协议，当省电模式为3时，必填）:20～10485.76间的值，精确到小数点后两位返回示例见附录B.6。A.3.6创建设备增加设备的接口要求如下：——接口方法：createDevice；——接口路径：api/open/device/；——请求方式：POST。请求参数见表A.7。表A.7createDevice是是是DB36/T1845—2023是是是productId是是返回示例见附录B.7。A.3.7删除设备删除设备数据的接口要求如下：——接口方法：deleteDevice；——接口路径：api/open/device/；——请求方式：DELETE。请求参数见表A.8。表A.8deleteDevice是productId是是是是返回示例见附录B.8。A.3.8更新设备更新设备数据的接口要求如下：——接口方法：updateDevice；——接口路径：api/open/device/；——请求方式：PUT。请求参数见表A.9。表A.9updateDevice是是是请求body（数据类型application/json;charset=utf-8）DB36/T1845—2023返回示例见附录B.9。A.3.9获取物模型查询属性列表信息，获取标准数据参数名称及数据类型的接口要求如下：——接口方法：queryPropertyList；——接口路径：api/open/model/properties/；——请求方式：GET。请求参数见表A.10。表A.10queryPropertyList是是productId是否否否否返回示例见附录B.10。A.3.10获取标准产品物模型标准农村人居环境长效管护平台标准物模型的接口要求如下：——接口方法：queryStandardModel；DB36/T1845—2023——接口路径：api/open/standardModel/；——请求方式：GET。请求参数见表A.11。表A.11queryStandardModel是是否否返回示例见附录B.11。A.3.11获取服务列表信息获取农村人居环境长效管护平台服务列表信息的接口要求如下：——接口方法：queryPropertyList；——接口路径：api/open/model/properties/；——请求方式：GET。请求参数见表A.12。表A.12queryPropertyList是是productId是否是否否返回示例见附录B.12。A.3.12智能垃圾桶数据上报智能垃圾桶设备上报数据的接口要求如下：——接口方法：uploadRubbishData；——接口路径：api/open/uploadData/；——请求方式：POST。请求参数见表A.13。表A.13uploadRubbishDataDB36/T1845—2023是body是请求Body（数据类型application/json;charset=utf-8）{"deviceId":"be04c3519c5740c1b82fe0fceb9d2e82","uploadTime":"2021-07-1916:29:41","latitude":"0.0","longitude":"0.0","errorCode":"0000","fireState":"0","tiltAngle":"0","powerState":"0","temperature":24,"deviceState":null,"batteryValue":0,"locationFlag":null,"fireThreshold":0,"fullThreshold":0,"tiltThreshold":null,"batteryVoltage":3.63,"powerThreshold":0,"fullState":"0","inclineState":"0","high":464,"deviceNo":null,"imei":null}返回示例见附录B.13。A.3.13人员卡牌设备数据上报卡牌设备上报数据的接口要求如下：——接口方法：uploadCardData；——接口路径：api/open/uploadData/；——请求方式：POST。请求参数见表A.14。表A.14uploadCardDataDB36/T1845—2023是body是请求body{"deviceId":"e978A.35e8c6d4e9fbe9286cedc6aedcd","uploadTime":null,"longitude":"114.1700000","latitude":"26.4400000","speed":2,"direction":null,"signal":null,"battery":"31","gpsFlag":null,"receiveTime":"2021-07-2118:13:06.133","createTime":"2021-07-2209:55:54","heading":null,"valid":"0","imei":null}返回示例见附录B.14。A.3.14智慧厕改设备数据上报厕改设备上报数据的接口要求如下：——接口方法：uploadToiletData；——接口路径：api/open/uploadData/；——请求方式：POST。请求参数见表A.15。表A.15uploadToiletData是body是请求body{"deviceId":,"deviceName":null,"uploadTime":"2021-08-2715:49:00","humWoman":null,DB36/T1845—2023"tempWoman":null,"h2sWoman":null,"nh3Woman":null,"humMan":"81.108642578125","tempMan":"28.8987979888916","h2sMan":"0.0010200000833719969","nh3Man":"0.004118899814784527","squatIdleWoman":0,"squatIdleMan":0,"pfWoman":null,"pfMan":null,"createTime":null,"imei":null}返回示例见附录B.15。A.3.15污水监测设备上报数据污水监测设备上报数据的接口要求如下：——接口方法：uploadWaterData；——接口路径：api/open/uploadData/；——请求方式：POST。请求参数见表A.16。表A.16uploadWaterData是body是请求body{"deviceId":"15036215BK7201SN001625","uploadTime":"2021-08-0417:01:03","temperature":29,"conductivity":1,"turbidity":1348.2,"ph":7.31,"doxygen":5.670000076293945,"imei":null}返回示例见附录B.16。DB36/T1845—2023A.3.16车载设备数据上报车载设备上报数据的接口要求如下：——接口方法：uploadCarData；——接口路径：api/open/uploadData/；——请求方式：POST。请求参数见表A.17。表A.17uploadCarData是body是请求body：{"deviceId":"a6fdce27e9844ba5b0b9f97ae7d40136","uploadTime":"2021-04-0215:42:17","batteryVoltage":360,"batteryStatus":0,"reserved":0,"temperature":55,"speed":0,"latitude":29.384321,"longitude":117.23177,"height":15,"actualLevel":null,"dataSource":null,"syncStatus":0,"syncTime":null,"alarm":0,"mileage":0,"recorderSpeed":0,"gpsswitch":1,"imei":null}返回示例见附录B.17。A.3.17空气站设备数据上报空气站设备上报数据的接口要求如下：——接口方法：uploadAirData；——接口路径：api/open/uploadData/；——请求方式：POST。请求参数见表A.18。DB36/T1845—2023表A.18uploadAirData是body是请求body{"deviceId":,"temperature":"0","humidity":"0","windSpeed":"0","windDirection":"0","pressure":"0","uploadTime":"2021-07-2211:38:10","rainfall":null,"dailyRainfall":null,"lightintensity":null,"no2":"4.253","so2":null,"pm10":"32.261","pm25":"6.425"}返回示例见附录B.18。A.4设备数据管理A.4.1获取设备监测数据根据设备Id设备类别获取设备上报监测数据，获取数据的接口要求如下：——接口方法：getDeviceDataById；——接口路径：api/open/device/；——请求方式：POST。请求参数见表A.19。表A.19getDeviceDataById是是是表A.19getDeviceDataById（续）DB36/T1845—2023否否返回示例见附录B.19。A.4.2获取设备原始上传数据包获取设备原始上传数据格式的接口要求如下：——接口方法：getBasicDataList；——接口路径：api/open/basicData/；——请求方式：POST。请求参数见表A.20。表A.20getBasicDataList是否是是返回示例见附录B.20。A.4.3获取设备上报事件信息获取设备上报事件信息的接口要求如下：——接口方法：getEventBasicDataList；——接口路径：api/open/events/；——请求方式：POST。请求参数见表A.21。表A.21getEventBasicDataList是否否是是返回示例见附录B.21。A.4.4获取智能垃圾桶数据获取智能垃圾桶设备上报数据的接口要求如下：——接口方法：getRubbishData；——接口路径：api/open/deviceData/；DB36/T1845—2023——请求方式：POST。请求参数见表A.22。表A.22getRubbishData是是是返回示例见附录B.22。A.4.5获取人员卡牌设备数据获取卡牌设备上报数据的接口要求如下：——接口方法：getCardData；——接口路径：api/open/deviceData/；——请求方式：POST。请求参数见表A.23。表A.23getCardData是是区域code（依据中国行政区域编码划分规则）是返回示例见附录B.23。A.4.6获取污水监测设备数据获取污水监测设备上报数据的接口要求如下：——接口方法：getWaterData；——接口路径：api/open/deviceData/；——请求方式：POST。请求参数见表A.24。表A.24getWaterData是是是返回示例见附录B.24。A.4.7获取车载设备数据DB36/T1845—2023获取车载设备上报数据的接口要求如下：接口方法：getCarData；接口路径：api/open/deviceData/；请求方式：POST。请求参数见表A.25。表A.25getCarData是是是返回示例见附录B.25。A.4.8获取智慧厕改设备数据获取厕改设备上报数据的接口要求如下：——接口方法：getToiletData；——接口路径：api/open/deviceData/；——请求方式：POST。请求参数见表A.26。表A.26getToiletData是是是返回示例见附录B.26。A.4.9获取空气站设备数据获取空气站设备上报数据的接口要求如下：——接口方法：getAirData；——接口路径：api/open/deviceData/；——请求方式：POST。请求参数见表A.27。表A.27getAirDataDB36/T1845—2023是是是返回示例见附录B.27。DB36/T1845—2023返回接口示例B.1获取令牌接口返回示例以JSON格式返回结果数据，格式定义如下：{msg:success,"code":0,"data":{"expireTime":"2021-03-3010:24:28","expire":86400,"token":"eyJhbGciOiJIUzUxMiJ9.eyJhcHBTZWNyZXQiOiJudWxsIiwiZXhwIjoxNjI5NjgxNTA.3LCJjcmVhdGVkIjoxNjI5NjgwNjA.3ODM4LCJhcHBJZCI6Im51bGwifQ.l-OCLUw8TTEyngvpExaJ7Q-sBCZiVDVJxGDEEHCcrHxo9-rx_-8RbGVqT7IEjsFqMHAM_CJAfatYjaNfh0JZ7g"返回参数说明见表B.1：表B.1获取令牌接口返回示例B.2产品列表接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":"0","msg":"成功","data":[{“productId”:1532043"apiKey":"b0910dc269db472fb45823292e706f3e","authType":1,"createBy":"user",DB36/T1845—2023"createTime":1535942487000,"dataEncryption":5,"deviceCount":4,"endpointFormat":1,"lwm2mEdrxTime":25.2,"networkType":3,"nodeType":1,"payloadFormat":2,"powerModel":1,"productDesc":"","productId":307,“productName":"tup-test-zcj","productProtocol":4,"productType":1,"productTypeValue":"家电","rootCert":"","secondaryType":2,"secondaryTypeValue":"测试","tenantId":"10007905","thirdType":13,"thirdTypeValue":"测试tanglv","tupIsThrough":1,"updateBy":"user","updateTime":1535943389000}返回参数说明见表B.2。表B.2产品列表接口返回示例productIdpowerModel表B.2产品列表接口返回示例（续）DB36/T1845—2023productProtocolpowerModelStrproductProtocolStrpayloadFormatStr认证，4:IMEI认证，5:SIMID认证，B.3设备列表接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":"0","msg":"成功","data":[DB36/T1845—2023{"deviceSn":"006","deviceId":,"deviceName":"测试厕改设备","productId":null,"deviceStatus":0,"deviceStatusStr":"已激活","netStatus":0,"netStatusStr":"在线","productProtocol":7,"productProtocolStr":"TCP协议","createTime":"2021-07-2109:32:46","updateTime":null,"activeTime":null,"offlineAt":"2021-07-2409:06:35","onlineAt":"2021-07-2409:06:44","facilityCategory":"XXX","dataSource":null}"count":159}返回参数说明见表B.3。表B.3设备列表接口返回示例productIdnetStatusnetStatusStrproductProtocol设备通讯协议（integer，产品协议：1.T-LINK协议2.MQTT协议3.LWM2M协议私有UDP（网关子设备协议）10.网关产品MQTT（网关产品productProtocolStr表B.3设备列表接口返回示例（续）DB36/T1845—2023B.4新建产品接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{"productId":10012761,"productName":"测试创建产品","tenantId":"300","productDesc":"创建产品","productType":10024,"secondaryType":10025,"thirdType":10026,"productProtocol":1,"authType":1,"payloadFormat":1,"createTime":1571402267678,"updateTime":1571402268678,"networkType":4,"endpointFormat":1,"powerModel":1,"apiKey":"67141cddbf2e4f62A.3ff458f1dd9ba8e","onlineDeviceCount":0,"deviceCount":3,"productTypeValue":"家电","secondaryTypeValue":"测试","thirdTypeValue":"测试tanglv","rootCert":1,"createBy":"user","updateBy":"user","accessType":2,"nodeType":1,"tupIsThrough":1,"dataEncryption":5,DB36/T1845—2023"lwm2mEdrxTime":15.2}}返回参数说明见表B.4。表B.4新建产品接口返回示例否否否productId否否tenantId否否否否否productProtocol否协议4.TUP协议5.HTTP协议6.JT/T8087.TCP协议8.私有TCP（网关子设备协议）9.私有UDP（网关子设备协议）10.网关产品MQTT（网关产品否否否否否否1.IMEI2.URN:IMEI:#########################-###############4.URN:IMpowerModel否否否否否否否否表B.4新建产品接口返回示例（续）DB36/T1845—2023否否否否接入类型：1.设备直连，2.网关接入，3.南向云接否是否透传：0.透传，1不透传（JT/T808，只有透传，消息格式必须只能传否数据加密方式1:sm1,2:sm2,3:sm4,否B.5删除产品接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"string"}返回参数说明见表B.5。表B.5删除产品接口返回示例B.6更新产品接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok"}返回参数说明见表B.6。表B.6更新产品接口返回示例B.7创建设备接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,DB36/T1845—2023"msg":"ok","result":{"deviceId":"89e920fa0eda47a89f04f52a88b17146","deviceName":"test003","tenantId":"300","productId":10003304,"imei":"125658789874565","deviceSn":"","token":"Tyhp7mYXm1k_upy44j32vw8GlKGH8gwvgdayOX27_2E"}返回参数说明见表B.7。表B.7创建设备接口返回示例productIdtenantIdB.8删除设备接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"string"}返回参数说明见表B.8：表B.8删除设备接口返回示例B.9更新设备接口返回示例以JSON格式返回结果数据，格式定义如下：DB36/T1845—2023{"code":0,"msg":"string"}返回参数说明表B.9。表B.9更新设备接口返回示例参数名类型说明codeint当code为0成功返回数据msgStringcode描述B.10获取物模型接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{"pageNum":1,"pageSize":1,"propertyId":1,"propertyFlag":"asdggg","propertyName":"属性1","dataType":"fix-string","unit":"g","unitName":"克每毫升","description":"""propertyId":2,"propertyFlag":"a1","propertyName":"a1","dataType":"enum","enumDetail":{"3":"4",DB36/T1845—2023"description":"test""propertyId":3,"propertyFlag":"A.3","propertyName":"A.3","dataType":"float","unit":"ppm","len":4,"unitName":"百万分率","max":"2","description":"1""propertyId":4,"propertyFlag":"a3","propertyName":"a3","dataType":"bool","boolDetail":{"false":"关","true":"开""description":"test"}返回参数说明见表B.10。表B.10获取物模型接口返回示例propertyFlag表B.10获取物模型接口返回示例（续）DB36/T1845—2023枚举值enum。json格式数据类型及对应枚举值：int32int32,floatunitB.11获取标准产品物模型接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{"properties":[{"propertyFlag":"a1","propertyName":"a1","dataType":"enum","enumDetail":{"3":"4","description":"test"{"propertyFlag":"A.3","propertyName":"A.3","dataType":"float",DB36/T1845—2023"unit":"ppm","len":4,"unitName":"百万分率","max":"2","description":"1""services":[{"serviceId":8001,"serviceFlag":"a3","serviceName":"a3","serviceType":2,"eventType":1,"description":"a","properties":[{"propertyFlag":"A.3","serial":2"parameters":[{"parameterFlag":"c1","parameterName":"c1","dataType":"int32","unit":"g","len":4,"unitName":"克每毫升","max":"2","description":"1","serial":1}返回参数说明见表B.11。表B.11获取标准产品物模型接口返回示例DB36/T1845—2023integer事件类型只有事件上报才有unitpropertyFlag时间戳timestamp，枚举值enuB.12获取服务列表信息接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,DB36/T1845—2023"msg":"ok","result":{"pageNum":1,"pageSize":20,"serviceId":1,"serviceFlag":"asdg","serviceName":"阿萨德刚","serviceType":2,"eventType":1,"description":"","properties":[{"propertyId":1,"propertyFlag":"asdggg","propertyName":"属性1","dataType":"fix-string","unit":"g","unitName":"克每毫升","description":"""propertyId":2,"propertyFlag":"a1","propertyName":"a1","dataType":"enum","enumDetail":{"3":"4","description":"test""propertyId":4,"propertyFlag":"a3","propertyName":"a3","dataType":"bool","boolDetail":{"false":"关","true":"开"DB36/T1845—2023"description":"test""parameters":[{"parameterId":17,"parameterFlag":"cellId","parameterName":"cellId","dataType":"integer","unit":"null","min":-2147483648,"len":4,"unitName":"","max":2147483647,"description":""}返回参数说明见表B.12。表B.12获取服务列表信息接口返回示例unit表B.12获取服务列表信息接口返回示例（续）DB36/T1845—2023fix-string，定长binaryfix-binary，无符字符串vary-string，变长binaryv浮点型float，时间戳timestamp，枚举值enum枚举值：int32int32,floatfloat,doubledouble，枚举型enpropertyFlagB.13智能垃圾桶数据上报接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{{"deviceId":"be04c3519c5740c1b82fe0fceb9d2e82","uploadTime":"2021-07-1916:29:41","latitude":"0.0","longitude":"0.0","errorCode":"0000","fireState":"0","tiltAngle":"0","powerState":"0","temperature":24,"deviceState":null,"batteryValue":0,"locationFlag":null,"fireThreshold":0,"fullThreshold":0,"tiltThreshold":null,"batteryVoltage":3.63,"powerThreshold":0,"fullState":"0","inclineState":"0","high":464,DB36/T1845—2023"deviceNo":null,"imei":null}参数说明见表B.13。表B.13智能垃圾桶数据上报接口返回示例否否是是是是是否否否否否否否否否tiltThreshold否否powerThreshold否否否否是是B.14人员卡牌设备数据上报接口返回示例DB36/T1845—2023以JSON格式返回结果数据，格式定义如下：{"code":"0","msg":"成功","data":[{"deviceId":"e978A.35e8c6d4e9fbe9286cedc6aedcd","uploadTime":null,"longitude":"114.1700000","latitude":"26.4400000","speed":2,"direction":null,"signal":null,"battery":"31","gpsFlag":null,"receiveTime":"2021-07-2118:13:06.133","createTime":"2021-07-2209:55:54","valid":"0","sosAlarm":"0","imei":null参数说明见表B.14。表B.14人员卡牌设备数据上报接口返回示例否否是否是是否否否DB36/T1845—2023表B.14人员卡牌设备数据上报接口返回示例（续）battery否否否否否否B.15智慧厕改设备数据上报接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{{"deviceId":,"deviceName":null,"uploadTime":"2021-08-2715:49:00","humWoman":null,"tempWoman":null,"h2sWoman":null,"nh3Woman":null,"humMan":"81.108642578125","tempMan":"28.8987979888916","h2sMan":"0.0010200000833719969","nh3Man":"0.004118899814784527","squatIdleWoman":0,"squatIdleMan":0,"pfWoman":null,"pfMan":null,"createTime":null,"imei":null}参数说明见表B.15。DB36/T1845—2023表B.15智慧厕改设备数据上报接口返回示例否否是否是否否否否否否否nh3Man否否否否否是B.16污水监测设备上报数据接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{{"deviceId":"15036215BK7201SN001625","uploadTime":"2021-08-0417:01:03","temperature":29,"conductivity":1,"turbidity":1348.2,"ph":7.31,DB36/T1845—2023"doxygen":5.670000076293945,"imei":null}参数说明见表B.16。表B.16污水监测设备上报数据接口返回示例否否是是否否否ph否pH值否是B.17车载设备数据上报接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{{"deviceId":"a6fdce27e9844ba5b0b9f97ae7d40136","uploadTime":"2021-04-0215:42:17","batteryVoltage":360,"batteryStatus":0,"reserved":0,"temperature":55,"speed":0,"latitude":29.384321,"longitude":117.23177,"height":15,"actualLevel":null,DB36/T1845—2023"dataSource":null,"syncStatus":0,"syncTime":null,"alarm":0,"mileage":0,"recorderSpeed":0,"gpsswitch":1,"imei":null}参数说明表B.17。表B.17车载设备数据上报接口返回示例否否是是batteryStatus否否否否否是是否是B.18空气站设备数据上报接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":0,"msg":"ok","result":{{DB36/T1845—2023"deviceId":,"temperature":"0","humidity":"0","windSpeed":"0","windDirection":"0","pressure":"0","uploadTime":"2021-07-2211:38:10","rainfall":null,"dailyRainfall":null,"lightintensity":null,"no2":"4.253","so2":null,"pm10":"32.261","pm25":"6.425"参数说明见表B.18。表B.18空气站设备数据上报接口返回示例否否是是否humidity否否否pressure否否否否no2否否否否DB36/T1845—2023B.19获取设备监测数据接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":"0","msg":"成功","data":[{"deviceId":"6f27fd0ad99d43bbb50a3adc1de4cada","uploadTime":"2021-07-1112:35:09","latitude":"0.0","longitude":"0.0","errorCode":"0000","fireState":"0","tiltAngle":"0","powerState":"0","temperature":40,"deviceState":null,"batteryValue":0,"locationFlag":null,"fireThreshold":0,"fullThreshold":0,"tiltThreshold":null,"batteryVoltage":3.62,"powerThreshold":0,"fullState":"0","inclineState":"0","high":9999,"deviceNo":null,"imei":null"count":38}参数说明见表B.19。表B.19获取设备监测数据接口返回示例DB36/T1845—2023表B.19获取设备监测数据接口返回示例（续）pcipcitiltThresholdpowerThresholdhighDB36/T1845—2023B.20获取设备原始上传数据包接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":"0","msg":"成功","data":[{"deviceType":null,"productId":null,"deviceId":null,"deviceName":"古田村-井冈山","protocol":"tcp","messageType":null,"messageTypeStr":"数据上报","assocAssetId":null,"topic":null,"upDataSN":0,"serviceId":null,"serviceName":null,"payload":"{\"hum_man\":73.8302001953125,\"H2S_man\":0.0010200000833719969,\"temp_man\":29.156200408935547,\"NH3_man\":0.0014188999775797129}","timestamp":null,"syncTime":"2021-08-2409:52:39","uploadTime":null,"syncStatus":0,"imei":null"count":77412}返回参数说明见表B.20。表B.20获取设备原始上传数据包接口返回示例DB36/T1845—2023表B.20获取设备原始上传数据包接口返回示例（续）protocolpayloadB.21获取设备上报事件信息接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":"0","msg":"成功","data":[{"deviceType":null,"productId":"15042251","deviceId":"4b349c049800421f8479f45f94b63a3f","deviceName":"尹仁生","protocol":"lwm2m","messageType":null,"messageTypeStr":"设备上下线状态上报","serviceId":null,"serviceName":null,"payload":null,"timestamp":null,"syncTime":"2021-08-1317:50:12","uploadTime":null,"syncStatus":0,"eventContent":null,"eventType":1,DB36/T1845—2023"eventTypeStr":"信息","imei":null"count":652}返回参数说明见表B.21。表B.21获取设备上报事件信息接口返回示例productIdprotocolpayloadB.22获取智能垃圾桶数据接口返回示例以JSON格式返回结果数据，格式定义如下：{"code":"0",DB36/T1845—2023"msg":"成功","data":[{"deviceId":"be04c3519c5740c1b82fe0fceb9d2e82","uploadTime":"2021-07-1916:29:41","latitude":"0.0","longitude":"0.0","errorCode":"0000","fireState":"0","tiltAngle":"0","powerState":"0","temperature":24,"deviceState":null,"batteryValue":