標(biāo)準(zhǔn)文本-《農(nóng)村人居環(huán)境長效管護(hù)平臺數(shù)據(jù)交換規(guī)范》

ICS點(diǎn)擊此處添加ICS號

點(diǎn)擊此處添加中國標(biāo)準(zhǔn)文獻(xiàn)分類號

DB

江西省地方標(biāo)準(zhǔn)

DBXX/XXXXX—XXXX

農(nóng)村人居環(huán)境長效管護(hù)平臺數(shù)據(jù)交換規(guī)范

Interfacespecificationforvillageenvironmentalgovernanceandlong-term

managementandprotectionplatform

點(diǎn)擊此處添加與國際標(biāo)準(zhǔn)一致性程度的標(biāo)識

（送審討論稿）

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

江西省質(zhì)量監(jiān)督管理局發(fā)布

DBXX/XXXXX—XXXX

目錄

前言Ill

引言IV

1范圍1

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

3術(shù)語和定義1

3.1農(nóng)村人居環(huán)境長效管護(hù)平臺(Rurallivingenvironmentlong-termmanagementplatform).1

3.2物聯(lián)網(wǎng)監(jiān)測數(shù)據(jù)共享模塊/系統(tǒng)(I0Tmonitoringdatasharingmodule/system)1

4概述2

5接口要求2

5.1約定2

6接口設(shè)計(jì)規(guī)范3

6.1基本規(guī)范3

6.2返回錯(cuò)誤碼code3

7設(shè)備數(shù)據(jù)上報(bào)頻次規(guī)范3

8數(shù)據(jù)提供方3

8.1身份認(rèn)證3

8.1.1獲取令牌接口3

8.2設(shè)備管理4

8.2.1產(chǎn)品列表4

8.2.2設(shè)備列表4

0.2.3新建產(chǎn)品5

8.2.4刪除產(chǎn)品7

8.2.5更新產(chǎn)品7

8.2.6創(chuàng)建設(shè)備8

8.2.7刪除設(shè)備9

8.2.8更新設(shè)備9

8.2.9獲取物模型10

8.2.10獲取標(biāo)準(zhǔn)產(chǎn)品物模型11

8.2.11獲取服務(wù)列表信息11

8.2.12智能垃圾桶數(shù)據(jù)上報(bào)12

8.2.13人員卡牌設(shè)備數(shù)據(jù)上報(bào)13

8.2.14智慧廁改設(shè)備數(shù)據(jù)上報(bào)14

8.2.15污水監(jiān)測設(shè)備上報(bào)數(shù)據(jù)15

8.2.16車載設(shè)備數(shù)據(jù)上報(bào)16

I

DBXX/XXXXX—XXXX

8.2.17空氣站設(shè)備數(shù)據(jù)上報(bào)17

9數(shù)據(jù)需求方18

9.1設(shè)備數(shù)據(jù)管理18

9.1.1獲取設(shè)備監(jiān)測數(shù)據(jù)18

9.1.2獲取設(shè)備原始上傳數(shù)據(jù)包18

9.1.3獲取設(shè)備上報(bào)事件信息19

9.1.4獲取智能垃圾桶數(shù)據(jù)19

9.1.5獲取人員卡牌設(shè)備數(shù)據(jù)19

9.1.6獲取污水監(jiān)測設(shè)備數(shù)據(jù)20

9.1.7獲取車載設(shè)備數(shù)據(jù)20

9.1.8獲取智慧廁改設(shè)備數(shù)據(jù)21

9.1.9獲取空氣站設(shè)備數(shù)據(jù)21

附錄A（資料性）接口返回示例22

II

DBXX/XXXXX—XXXX

-LX.

刖言

本標(biāo)準(zhǔn)按照GB/T1.1—2009《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分:標(biāo)準(zhǔn)的結(jié)構(gòu)和編寫》給出的規(guī)則起草。

本標(biāo)準(zhǔn)由江西省農(nóng)業(yè)農(nóng)村廳提出并歸口。

本標(biāo)準(zhǔn)起草單位：江西省農(nóng)業(yè)技術(shù)推廣中心、江西電信信息產(chǎn)業(yè)有限公司、江西省數(shù)字鄉(xiāng)村研究院

本標(biāo)準(zhǔn)主要起草人：陳勛洪、鐘志宏、楊眉、黃建昌、張敏、徐軍亮、姜?jiǎng)P文、鄧碧巖、官文峰。

III

DBXX/XXXXX—XXXX

引言

當(dāng)前農(nóng)村人居環(huán)境長效管護(hù)平臺接入的物聯(lián)網(wǎng)監(jiān)測平臺較多，涉及設(shè)備品牌繁多，各廠家平臺及設(shè)

備數(shù)據(jù)標(biāo)準(zhǔn)不一，從而導(dǎo)致對接成本、維護(hù)成本、運(yùn)營成本的增加，制約了平臺的快速建設(shè)推廣。為有

效加強(qiáng)全省農(nóng)村人居環(huán)境長效管護(hù)平臺建設(shè)的統(tǒng)一規(guī)劃、統(tǒng)一管理、協(xié)調(diào)運(yùn)行和維護(hù)服務(wù)，建立健全全

省農(nóng)村人居環(huán)境長效管護(hù)平臺的數(shù)據(jù)交換規(guī)范標(biāo)準(zhǔn)，推動(dòng)農(nóng)村人居環(huán)境長效管護(hù)平臺的建設(shè)運(yùn)營有序發(fā)

展，提升各級政府及其部門的農(nóng)村人居環(huán)境治理水平，現(xiàn)根據(jù)國家、地方相關(guān)文件要求和標(biāo)準(zhǔn)規(guī)范，結(jié)

合我省農(nóng)村人居環(huán)境治理現(xiàn)狀和發(fā)展要求，制定本規(guī)范。

IV

DBXX/XXXXX—XXXX

農(nóng)村人居環(huán)境長效管護(hù)平臺數(shù)據(jù)交換規(guī)范

1范圍

本標(biāo)準(zhǔn)規(guī)定了江西省農(nóng)村人居環(huán)境長效管護(hù)平臺數(shù)據(jù)交換的相關(guān)術(shù)語和定義、設(shè)計(jì)要求及接口要求。

本標(biāo)準(zhǔn)適用于江西省農(nóng)村人居環(huán)境長效管護(hù)平臺設(shè)計(jì)規(guī)范。

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

下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

件。凡是不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。

GB/T29765-2021信息安全技術(shù)數(shù)據(jù)備份與恢復(fù)產(chǎn)品技術(shù)要求與測試評價(jià)方法

GB/T20271信息安全技術(shù)信息系統(tǒng)通用安全技術(shù)要求

GB/T20273-2019信息安全技術(shù)數(shù)據(jù)庫管理系統(tǒng)安全技術(shù)要求

GB/T31496-2015信息技術(shù)安全技術(shù)信息安全管理體系實(shí)施指南

GB/T21063.6政務(wù)信息資源目錄體系第6部分：技術(shù)管理要求

GB/T15629信息技術(shù)系統(tǒng)間遠(yuǎn)程通信和信息交換局域網(wǎng)和城域網(wǎng)

GB/T28181-2016安全防范視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求

DB36/T981-2017電子政務(wù)共享數(shù)據(jù)統(tǒng)一交換平臺技術(shù)規(guī)范

DB36/T984—2017政務(wù)服務(wù)網(wǎng)集成對接規(guī)范

DB36/T1179—2019政務(wù)數(shù)據(jù)共享技術(shù)規(guī)范

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

GB/T36478.1-2018信息交換和共享

3術(shù)語和定義

GB/T33745-2017>GB/T36478.1-2018界定的以及下列術(shù)語和定義適用于本文件。

3.1農(nóng)村人居環(huán)境長效管護(hù)平臺(RuralIivingenvironmentlong-termmanagementplatform)

采用物聯(lián)網(wǎng)、云計(jì)算、大數(shù)據(jù)、AI等新一代信息技術(shù)，通過數(shù)字化技術(shù)驅(qū)動(dòng)農(nóng)村人居環(huán)境有效治

理，實(shí)現(xiàn)農(nóng)村人居環(huán)境長效管護(hù)數(shù)字化、環(huán)境監(jiān)測智能化、公眾監(jiān)督便捷化。平臺集“投訴、整改、反

饋、監(jiān)督”等功能為一體，以實(shí)現(xiàn)農(nóng)村人居環(huán)境持續(xù)改善及治理長效管護(hù)為目的，推動(dòng)鄉(xiāng)村由“一時(shí)美”

向“持久美”轉(zhuǎn)變。

3.2物聯(lián)網(wǎng)監(jiān)測數(shù)據(jù)共享模塊/系統(tǒng)(I0TmonitoringdatasharingmocuIe/system)

1

DBXX/XXXXX—XXXX

物聯(lián)網(wǎng)監(jiān)測數(shù)據(jù)共享模塊/系統(tǒng)（以下簡稱“共享平臺”），是面向農(nóng)村人居環(huán)境進(jìn)行智能化監(jiān)測的

傳感設(shè)備，這些設(shè)備的動(dòng)態(tài)監(jiān)測數(shù)據(jù)統(tǒng)一存儲在農(nóng)村人居環(huán)境長效管護(hù)平臺，并建立數(shù)據(jù)共享模塊來提

供數(shù)據(jù)服務(wù)。

4概述

依據(jù)國標(biāo)GB/T33745-2018中的規(guī)定，交換和共享數(shù)據(jù)模塊/系統(tǒng)既可以是物聯(lián)網(wǎng)系統(tǒng)中的一個(gè)功

能模塊，也可以是一個(gè)獨(dú)立的系統(tǒng)，通過數(shù)據(jù)接口方式，數(shù)據(jù)提供方通過物聯(lián)網(wǎng)系統(tǒng)將交換和共享的數(shù)

據(jù)導(dǎo)入到對應(yīng)的模塊/系統(tǒng);數(shù)據(jù)需求方從物聯(lián)網(wǎng)相應(yīng)模塊/系統(tǒng)獲取物聯(lián)網(wǎng)數(shù)據(jù),數(shù)據(jù)接口如圖1所示。

圖1數(shù)據(jù)接口

5接口要求

5.1約定

本章給出了共享平臺的基本接口方法、參數(shù)。接口應(yīng)與物聯(lián)網(wǎng)系統(tǒng)的軟件平臺無關(guān)，接口宜采用

WebService技術(shù)實(shí)現(xiàn)。以下接口描述，只規(guī)定了共享平臺實(shí)現(xiàn)的基本接口方法、參數(shù)項(xiàng)目、參數(shù)類型、

參數(shù)格式及命名規(guī)范。

為便于提供方和需求方統(tǒng)一調(diào)用數(shù)據(jù)，接口方法和參數(shù)宜采用英文命名。

2

DBXX/XXXXX—XXXX

6接口設(shè)計(jì)規(guī)范

6.1基本規(guī)范

接口地址:http://xxx.xxx.XXX.xxx：xxxx/o

接口協(xié)議：WebServiceo

編碼方式：UTF-8o

交換格式：JSON。

6.2返回錯(cuò)誤碼code

接口錯(cuò)誤碼返回標(biāo)準(zhǔn)規(guī)范見表1：

表1：返回錯(cuò)誤碼code及描述

參數(shù)名code值描述

0成功

999失敗

1111正在處理

7設(shè)備數(shù)據(jù)上報(bào)頻次規(guī)范

7.1數(shù)據(jù)上報(bào)頻次

智能垃圾桶：6小時(shí)/條，或12小時(shí)/條。

水質(zhì)監(jiān)測設(shè)備：6小時(shí)/條，或12小時(shí)/條。

氣味探測器：6小時(shí)/條，或12小時(shí)/條。

車載/卡牌：1分鐘以上/條。

環(huán)境探測器：6小時(shí)/條。

8數(shù)據(jù)提供方

8.1身份認(rèn)證

8.1.1獲取令牌接口

接口方法：getToken。

接口路徑：api/open/oauth/。

請求方式：POSTo

請求參數(shù)：見表2。

表2getToken

參數(shù)名必選類型說明

app_id是string由平臺頒發(fā)

app_secret是string由平臺頒發(fā)

返回示例：見附錄A.L

3

DBXX/XXXXX—XXXX

8.2設(shè)備管理

8.2.1產(chǎn)品列表

簡要描述：獲取農(nóng)村人居環(huán)境長效管護(hù)平臺標(biāo)準(zhǔn)物聯(lián)網(wǎng)產(chǎn)品。

接口方法:getProductListo

接口路徑：api/open/product/o

請求方式：POSTo

參數(shù)：見表3。

表3getProductList

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

參數(shù)名必選類型說明

productName否string產(chǎn)品名稱

產(chǎn)品協(xié)議：Integer,產(chǎn)品協(xié)議：LT-LINK協(xié)議2.MQTT協(xié)

議3.LWM2M協(xié)議4.TUP協(xié)議5.HTTP協(xié)議6.JT/T808

productProtocol否Integer

7.TCP協(xié)議8.私有TCP（網(wǎng)關(guān)子設(shè)備協(xié)議）9.私有UDP（網(wǎng)關(guān)

子設(shè)備協(xié)議）10.網(wǎng)關(guān)產(chǎn)品MQTT（網(wǎng)關(guān)產(chǎn)品協(xié)議）11.南向云

productId是Int產(chǎn)品id

返回示例:見附錄A.2。

8.2.2設(shè)備列表

簡要描述：獲取農(nóng)村人居環(huán)境長效管護(hù)平臺設(shè)備列表。

接口方法：getDeviceListo

接口路徑：api/open/device/o

請求方式：POSTo

請求參數(shù)：見表4。

表4getDeviceList

報(bào)頭參數(shù)名必選類型說明

Token是String通信證key

參數(shù)名必選類型說明

netStatus否Int設(shè)備狀態(tài)

deviceNo否String設(shè)備編號

4

DBXX/XXXXX—XXXX

參數(shù)名必選類型說明

productId是String產(chǎn)品id

gridCode是String區(qū)域code

返回示例:見附錄A.3。

8.2.3新建產(chǎn)品

簡要描述：添加產(chǎn)品（產(chǎn)品為設(shè)備直連+非NB網(wǎng)關(guān)協(xié)議）。

接口方法：CrealeProducto

接口路徑：api/opcn/product/。

請求方式：POSTo

請求參數(shù)：見表5。

表5CreateProduct

報(bào)頭參數(shù)名必選類型說明

Token是String通信證key

請求body（數(shù)據(jù)類型application/json;charset=utf-8）

5

naccessType":I,

'?authType":0,

"dataEncryption":0,

"deviceModel":"string",（XX

"encryptionType":0,

"endpointFormat":0.

,,lwm2mEdrxTime":null,

nmanufacturerld":"string",

"networkType":0,

"nodeType":1,

"payloadFormat":0,

"powerModel":0,

"productDesc":"string",

"productName":"string",

"productProtocor':0,

"productType":"string",

"secondaryType":"string",

nthirdType":"string",

"tupIsThrough":0,

MtupDeviceModelM:"string"

）

描述：

productName：產(chǎn)品名稱（必填）：產(chǎn)品名稱最多64個(gè)字符，產(chǎn)品名稱必須包含數(shù)字或字

母或漢字，產(chǎn)品名稱不能重生

productType：產(chǎn)品分類（必填）

secondaryType：二級分類（必填）

thirdType：三級分類（必填）

nodeType：節(jié)點(diǎn)類型（必填）：1.設(shè)備，2.網(wǎng)關(guān)

accessType：接入類型（必填）：1.設(shè)備直連，2.網(wǎng)關(guān)接入，3.南向云接入（只支持1）

networkType：網(wǎng)絡(luò)類型（必填）：1.WIFI,2.移動(dòng)蜂窩數(shù)據(jù)3.NB-IoT,4.以太網(wǎng),5.藍(lán)牙,6.ZigBee

（只支持1/2/3/4）

productProtocol：產(chǎn)品協(xié)議（必填）：只支持1.T-LINK協(xié)議2.MQTT協(xié)議3.LWM2M協(xié)議

5.HTTP協(xié)議6.JT/T8087.TCP協(xié)議10.網(wǎng)關(guān)MQTT協(xié)議

authType：認(rèn)證方式1:特征串認(rèn)證2sM9認(rèn)證,3:證書認(rèn)證,4:IMEI認(rèn)證，5:SIMID認(rèn)證，

6:SM2認(rèn)證，7:IPV6標(biāo)識認(rèn)證

payloadFormat：消息格式l:json,2:緊湊二進(jìn)制

dataEncryption：數(shù)據(jù)加密方式1:sml,2:sm2,3:sm4,4:dtls,5:明文（只支持MQTT/LWM2M）

encryptionType：安全類型（只支持MQTT,TCP協(xié)議）0:一機(jī)一密，1:一型一密

tupIsThrough：是否透傳：0.透傳，1不透傳（JT/T808,tep協(xié)議，只有透傳，消息格式必

須只能傳null）

deviceModel：JT/T808協(xié)議設(shè)備型號

manufacturerld：JT/T808協(xié)議制造商ID

endpointFormal:Endpoint格式（LWM2M協(xié)議必

+古、.1IITnNT.IXXCTIX4OT.

返回示例：見附錄A.4。

6

DBXX/XXXXX—XXXX

8.2.4刪除產(chǎn)品

簡要描述：刪除產(chǎn)品數(shù)據(jù)，如果產(chǎn)品下有設(shè)備數(shù)據(jù)，則無法刪除產(chǎn)品。

接口方法：deleteProducto

接口路徑：api/open/product/。

請求方式：Deleteo

請求參數(shù)：見表6。

表6deleteProduct

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

MasterKey是stringMasterKey在該設(shè)備所屬產(chǎn)品的概況中可以查看

報(bào)體參數(shù)名必選類型說明

productld是Int產(chǎn)品id

gridCode是String區(qū)域code

返回示例：見附錄A.5

8.2.5更新產(chǎn)品

簡要描述：更新產(chǎn)品數(shù)據(jù)。

接口方法：updatcProduct。

接口路徑：api/open/product/。

請求方式：puto

請求參數(shù)：見表7。

表7updateProduct

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

報(bào)體參數(shù)名必選類型說明

gridCode是String區(qū)域code

請求body（數(shù)據(jù)類型application/json;charsct=utf-8）

^endpointFormat*:null,

7

DBXX/XXXXX—XXXX

“powerModel”:null,

“productDesc":"string”,

“productld”:0,

〃product、ame":"string”,

，/lwm2mEdrxTime//:null

）

描述：

productId:產(chǎn)品ID,必填

productName：產(chǎn)品名稱，產(chǎn)品名稱租戶內(nèi)不能重復(fù)，必填

productDesc：產(chǎn)品描述，選填

endpointFormat：endpoint類型（Lwm2m協(xié)議必填）1.IMEI2.URN:IMEI:###############

3.URN:IMEI-IMSI:###############一###############4.URN:IMEI+SM9

注：認(rèn)證方式為SM9認(rèn)證時(shí)，endpoint類型為4

認(rèn)證方式為IMEI認(rèn)證、sm2認(rèn)證時(shí)，endpoint類型為1、2、3

powerModel：省電模式（Lwm2m協(xié)議必填）1.PSM2.DRX3.eDRX

lwm2mEdrxTime：eDRX模式時(shí)間窗（LWM2M協(xié)議,當(dāng)省電模式為3時(shí)，必填）：20?10485.76間的值，精確

到小數(shù)點(diǎn)后兩位

返回示例：見附錄A.6。

8.2.6創(chuàng)建設(shè)備

簡要描述：增加設(shè)備。

接口方法：CreateDeviceo

接口路徑：api/open/device/o

請求方式：POSTo

請求參數(shù)：見表8。

表8CreateDevice

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

報(bào)體參數(shù)名必選類型說明

MasterKey是StringMasterKey在該設(shè)備所屬產(chǎn)品的概況中可以查看

gridCode是String區(qū)域code

deviseName是String設(shè)備名稱

deviceSn是String設(shè)備編號

Imei是StringImei號

8

DBXX/XXXXX—XXXX

報(bào)體參數(shù)名必選類型說明

productId是Int產(chǎn)品id

operator是String操作人

返回示例：見附錄A.7。

8.2.7刪除設(shè)備

簡要描述：刪除設(shè)備數(shù)據(jù)。

接口方法：deleteDeviceo

接口路徑：api/open/device/o

請求方式：Deleteo

請求參數(shù)：見表9。

表9deleteDevice

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

報(bào)體參數(shù)名必選類型說明

productId是Int產(chǎn)品id

可以刪除多個(gè)設(shè)備（最多支持200個(gè)設(shè)備）。多個(gè)設(shè)備id,

devicelds是string

中間以逗號隔開。

MasterKey是StringMasterKey在該設(shè)備所屬產(chǎn)品的概況中可以查看

gridCode是String區(qū)域code

返回示例：見B寸錄A.8

8.2.8更新設(shè)備

簡要描述：更新設(shè)備數(shù)據(jù)。

接口方法：updateDevice。

接口路徑：api/open/device/o

請求方式：PUT.

請求參數(shù)：見表10。

表10updateDevice

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

MasterKey是String

9

DBXX/XXXXX—XXXX

請求參數(shù)名必選類型說明

gridCode是String區(qū)域code

請求body(數(shù)據(jù)類型application/json;charset=utf-8)

(

"deviceName":"string",

"operator":"string",

"other":{"autoObserver":0,

"imsin:n12545154878451"),

"produclld":0

1

1

描述：

deviceName:設(shè)備名稱，選填

operator:操作者，必填

other:LWM2M協(xié)議必填參數(shù)，其池協(xié)議不填：｛

autoObscrvcr:0.自動(dòng)訂閱1.取消自動(dòng)訂閱，訂閱指的是平臺訂閱設(shè)備能夠上報(bào)的

object數(shù)據(jù)選填；

imsi:總長度不超過15位,使用0~9的數(shù)字，String類型選填；

1

/

productld:產(chǎn)品ID,必填

返回示例：見附錄A.9

8.2.9獲取物模型

簡要描述：查詢屬性列表信息、，獲取標(biāo)準(zhǔn)數(shù)據(jù)參數(shù)名稱及數(shù)據(jù)類型

接口方法：QueryPropertyList

接口路徑：api/open/model/properties/

請求方式：GET

請求參數(shù)：見表11。

表11QueryPropertyList

報(bào)頭參數(shù)名必選類型說明

token是String通行證key

MasterKey是StringMasterKey在該設(shè)備所屬產(chǎn)品的概況中可以查看

報(bào)體參數(shù)名必選類型說明

productld是Int產(chǎn)品Id

searchValue否String可填值：屬性名稱，屬性

10

DBXX/XXXXX—XXXX

報(bào)體參數(shù)名必選類型說明

gridCode否String區(qū)域code

pageNow否Int當(dāng)前頁數(shù)

pageSize否Int每頁記錄數(shù)

返回示例：見附錄A.10

8.2.10獲取標(biāo)準(zhǔn)產(chǎn)品物模型

簡要描述：標(biāo)準(zhǔn)農(nóng)村人居環(huán)境長效管護(hù)平臺標(biāo)準(zhǔn)物模型。

接口方法：QucryStandardModclo

接口路徑：api/open/standardModel/o

請求方式：GETo

請求參數(shù)：見表12。

表12QueryStandardModel

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

MasterKcy是StringMasterKey在該設(shè)備所屬產(chǎn)品的概況中可以查看

報(bào)體參數(shù)名必選類型說明

standardVersion否String標(biāo)準(zhǔn)物模型版本號

thirdType否Int三級分類id

返回示例：見附錄A.11。

8.2.11獲取服務(wù)列表信息

簡要描述：獲取農(nóng)村人居環(huán)境長效管護(hù)平臺服務(wù)列表信息。

接口方法：QueryPropertyList0

接口路徑：叩i/open/model/properties/。

請求方式：GETo

請求參數(shù)：見表13。

表13QueryPropertyList

報(bào)頭參數(shù)名必選類型說明

11

DBXX/XXXXX—XXXX

tnknn是String通信證key

MasterKey是StringMasterKey在該設(shè)備所屬產(chǎn)品的概況中可以查看

報(bào)體參數(shù)名必選類型說明

productld是Int產(chǎn)品Id

可填值：屬性名稱，屬性標(biāo)

searchValue否String

識符

gridCode是String區(qū)域code

pageNow否Int當(dāng)前頁數(shù)

pageSize否Int每頁記錄數(shù)

8.2.12智能垃圾桶數(shù)據(jù)上報(bào)

簡要描述：智能垃圾桶設(shè)備上報(bào)數(shù)據(jù)。

接口方法：uploadRubbishDatao

接II路徑：api/open/uploadData/.

請求方式：Posto

請求參數(shù)：見表14。

表14uploadRubbishData

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

報(bào)體參數(shù)名必選類型說明

body是String智能垃圾桶標(biāo)準(zhǔn)物模型

請求Body（數(shù)據(jù)類型application/json;charset=utf-8）

"deviceld":"be04c3519c5740c1b82fe0fceb9d2e82",

"uploadTime":"2021-07-1916:29:4ln,

"latitude,^:"0.0",

"longitude":"0.0",

"errorCode":"0000”,

"fireState":n0",

"tiltAngle":"0"，

"powerState":"0",

"temperature":24,

12

DBXX/XXXXX—XXXX

"deviceState":null.

"batteryValue":0,

"locationFIag":null,

"fireThreshold":0,

"fullThreshold":0,

“iltThreshold"：null,

"batteryVoltage":3.63,

"powerThreshold":0,

"fullState":"0",

"inclineState":"O'1,

"high'1:464,

"deviceNo":null,

"imei":null

返回示例：見附錄A.13。

8.2.13人員卡牌設(shè)備數(shù)據(jù)上報(bào)

簡要描述：卡牌設(shè)備上報(bào)數(shù)據(jù)。

接口方法：uploadCardData。

接口路徑：api/open/upIoadData/,

請求方式：Posto

請求參數(shù)：見表15。

表15uploadCardData

報(bào)頭參數(shù)名必選類型說明

Token是String通信證key

報(bào)體參數(shù)名必選類型說明

body是String人員卡牌標(biāo)準(zhǔn)物模型

請求body

"deviceld":"e978a25e8c6d4e9fbe9286cedc6aedcd",

"uploadTime":null,

"longitude11:"114.1700000",

"latitude":"26.4400C00",

"speed":2,

"direction":null,

13

DBXX/XXXXX—XXXX

"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

)

返回示例：見附錄A.14。

8.2.14智慧廁改設(shè)備數(shù)據(jù)上報(bào)

簡要描述：廁改設(shè)備上報(bào)數(shù)據(jù)。

接口方法：uploadToiletDatao

接口路徑：api/open/uploadData/o

請求方式：Posto

請求參數(shù)：見表I6o

表16uploadToilctData

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

報(bào)體參數(shù)名必選類型說明

body是String智慧廁改設(shè)備標(biāo)準(zhǔn)物模型

請求body

14

DBXX/XXXXX—XXXX

(

"deviceld":;

"deviceName":null,

"uploadTime":"2021-08-2715:49:00”，

"humWoman":null,

"tempWoman":null,

"h2sWomanu:null,

"nhSWoman":null,

"humMan":H81.108642578125",

"tempMan*':"28.8987979888916",

"h2sMan":"0.0010200000833719969",

"nh3Man":"0.004118899814784527",

"squatldlcWoman*':0,

"squatldleMan":0,

"pfWoman":null,

"ptMan":null,

"createTime":null,

"imein:null

)

返回示例：見附錄A.15。

8.2.15污水監(jiān)測設(shè)備上報(bào)數(shù)據(jù)

簡要描述：污水監(jiān)測設(shè)備上報(bào)數(shù)據(jù)。

接口方法：uploadWalerDaia。

接口路徑：api/open/uploadData/。

請求方式：Post。

請求參數(shù)：見表17。

表17uploadWaterData

報(bào)頭參數(shù)名必選類型說明

token是String通信證key

報(bào)體參數(shù)名必選類型說明

body是String污水監(jiān)測設(shè)備標(biāo)準(zhǔn)物模型

請求body

(

"deviceld":"15036215BK7201SN001625”,

15

DBXX/XXXXX—XXXX

"uploadTime":"2021-08-0417:01:03".

"temperature'1:29,

"conductivity":1,

,'turbidity":1348.2,

"ph":7.31,

Mdoxygen":5.6700(X)076293945,

"imei":null

I

返回示例：見附錄A.16。

8.2.16車載設(shè)備數(shù)據(jù)上報(bào)

簡要描述：車載設(shè)備上報(bào)數(shù)據(jù)。

接口方法：uploadCarData。

接口路徑：