ICS35.100.20 CCSL72DB36 江西省地方标准 DB36/T1845—2023 农村人居环境长效管护平台数据交换规范 Dataexchangespecificationforlong-termmanagementandprotectionplatformof rurallivingenvironment 2023-09-18发布 2024-03-01实施 江西省市场监督管理局发布 DB36/T1845—2023 I目  次 前言..................................................................................II 引言.................................................................................III 1范围................................................................................1 2规范性引用文件......................................................................1 3术语和定义..........................................................................1 4数据交换流程........................................................................1 5接口要求............................................................................2 6接口设计............................................................................3 7设备上报频次........................................................................4 8设备离线存储、断点续传..............................................................4 附录A（资料性）接口设计标准............................................................5 附录B（资料性）返回接口示例...........................................................22 DB36/T1845—2023 II前  言 本文件按照GB/T1.1－2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起 草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由江西省农业农村厅提出并归口。 本文件起草单位：江西省农业技术推广中心、江西电信信息产业有限公司、江西省数字乡村研究院。 本文件主要起草人：陈勋洪、钟志宏、杨眉、黄建昌、张敏、徐军亮、姜凯文、邓碧岩、官文峰。 DB36/T1845—2023 III引  言 当前农村人居环境长效管护平台接入的物联网监测平台较多，涉及设备品牌繁多，各厂家平台及设 备数据标准不一，从而导致对接成本、维护成本、运营成本的增加，制约了平台的快速建设推广。为有 效加强全省农村人居环境长效管护平台建设的统一规划、统一管理、协调运行和维护服务，建立健全全 省农村人居环境长效管护平台的数据交换标准，推动农村人居环境长效管护平台的建设运营有序发展， 提升各级政府及其部门的农村人居环境治理水平，现根据国家、地方相关文件要求和标准，结合我省农 村人居环境治理现状和发展要求，制定本文件。 DB36/T1845—2023 1农村人居环境长效管护平台数据交换规范 1范围 本文件规定了农村人居环境长效管护平台接口数据交换的相关术语和定义、数据交换流程、接口要 求、接口设计、设备数据上报频次、设备数据断点续传。 本文件适用于农村人居环境长效管护平台接口设计。 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数据交换流程 DB36/T1845—2023 2依据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。