ICS 65.020.30 CCS B 40 重 DB50 庆 市 地 方 标 准 DB50/T 1096.4—2021 畜牧兽医大数据应用与管理 第 4 部分：数据接口 2021-03-30 发布 2021-07- 01 实施 重庆市市场监督管理局 发 布 DB50/T 1096.4—2021 前  言 本文件按照GB/T 1.1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》的规定 起草。 本文件是DB50/T 1096的第 4 部分。DB50/T 1096已发布了以下部分： ----第 1 部分：总则 ----第 2 部分：元数据 ----第 3 部分：信息分类与编码 ----第 4 部分：数据接口 ----第 5 部分：共享交换技术要求 ----第 6 部分：信息资源目录 ----第 7 部分：管理要求 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由重庆市农业农村委员会提出并归口。 本文件起草单位：重庆市畜牧技术推广总站、重庆大学、广州中科易德科技有限公司、西南大学、 广州中国科学院软件应用技术研究所。 本文件主要起草人：夏云霓、李晓波、古平、李引、陈红跃、樊莉、张科、何道领、黄文明、朱燕、 赖鑫、高敏、陈雷。 I DB50/T 1096.4—2021 畜牧兽医大数据应用与管理 第 4 部分：数据接口 1 范围 本文件规定了畜牧兽医行业大数据中数据接口的术语、定义和缩略语，网络要求和接口协议。 本文件适用于畜牧兽医云系统之间数据的对接与传输。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 36345 信息技术 通用数据导入接口 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 数据接口 data interface 数据对接与传输过程中所需要的软硬件、网络环境及其在数据交换时需要符合的通信方式和要求。 3.2 缩略语 本文件中使用的缩略语如下： VPN：虚拟专用网（Virtual Private Network） TCP/IP：传输控制协议/网际协议（Transmission Control Protocol/Internet Protocol） HTTP：超文本传输协议（HyperText Transfer Protocol） AES：高级加密标准（Advanced Encryption Standard） MD5：消息摘要算法第五版（Message-Digest Algorithm 5） CRC：循环冗余校验（Cyclic Redundancy Check） JSON：JS 对象标记（JavaScript Object Notation） 4 网络要求 4.1 网络结构 1 DB50/T 1096.4—2021 畜牧兽医云通过互联网与各级管理与服务系统交换数据、发起和应答指令，具体见图1。 图1 4.2 畜牧兽医云网络结构 网络连接 畜牧兽医云应具有固定 IP 地址、端口号，通过 VPN 与各级管理与服务系统实现连接。 4.3 VPN 功能要求 VPN 功能要求见表 1。 表1 5 VPN 功能要求 功能要求 描述 WEB 应用加速 对 WEB 访问资源的压缩 身份认证 支持短信认证、USB KEY 认证 单点登录 支持单点登录 备份功能 支持本地和远程备份及恢复 接口协议 5.1 5.1.1 基本要求 通信协议 数据通信基于TCP/IP协议和 HTTP协议，并符合GB/T 36345的要求。包括以下情况： a） 建立连接：采用HTTP通信方式，进行端口监听，准备接收连接请求，并根据业务需求进行数据 传输，传输结束后断开网络； b）自动重连：各级管理与服务系统应定时向畜牧兽医云发送心跳数据包，并监测连接的状态，当 监测到网络连接断开时，应自动重建连接； c）超时重发：一条指令发出后，在规定时间内未收到回应，则认为超时；超时后应重发，重发 3 次 后，仍未收到回应，则认为通讯失败，应自动重建连接。超时时间可根据具体情况自行设定； 2 DB50/T 1096.4—2021 d）通信周期：支持被动传输和主动定时传输两种数据传输模式，主动定时传输周期可从 5 min 到 24h 灵活配置。 5.1.2 数据安全 畜牧兽医云数据传输使用AES加密；身份认证使用MD5校验。 5.1.3 数据可靠性 数据包中的实体数据使用CRC校验，其中实体数据的组成见图 2。 5.1.4 数据扩展性 数据包中指令内容采用JSON格式，可新增字段支持后期扩展。 5.2 接口协议数据结构 5.2.1 数据包的组成 接口协议数据包的组成应符合图 2 的规定。其中实体数据为经过AES加密的JSON格式数据，加密后 以ASCII码的格式进行传输，其他数据明码传输。 5.2.2 图2 数据包的组成 表2 数据包的结构 数据包的结构 数据包的结构见表 2。 5.2.3 项目 类型 长度 说明 包头 十六进制 4字节 固定为0x68 0x68 0x16 0x16 实体数据总长度 十六进制 4字节 代表当前数据包中的实体数据长度 实体数据 字符 N字节（M+4） CRC校验 十六进制 2字节 对实体数据进行CRC校验 包尾 十六进制 4字节 固定为0x55 0xAA 0x55 0xAA 实体数据为数据包的实体内容。M含义见表3 实体数据的结构 3 DB50/T 1096.4—2021 实体数据的结构见表 3。 表3 项目 类型 实体数据的结构 长度 说明 标识了各级管理与服务系统向畜牧兽医云发送的数 数据序列 十六进制 4字节 据序号，畜牧兽医云应答时，本项内容应按照各级 管理与服务系统提供的数据序号进行填充。 根据数据序号，内容不同，数据内容是经过AES加密 数据内容 字符 M字节 的JSON格式数据，加密后以ASCII码的格式进行传 输。 5.2.4 内容格式 数据内容采用 JSON 格式，示例见图3。 http://{SERVER_IP}/{SYTSTEM_NAME}/? …… Content-Type: application/json { "totalNum": 1, "data": [{ "P_OPERATION": "ADD", "OBJID": "5CFC5CABA549CA9DE050A8C0DD01357A", "GSZCH": null, "JYXM_DETAIL": "畜禽肉类产品销售", "ZTYT_DETAIL": "肉类销售点", "SHXYM": "92440604MA4X4E4U5H", "RCJDGLJG": "重庆市农业执法总队", "FDDBR": "张XX", …… }] } 图3 数据内容格式示例 4