畜牧兽医大数据应用与管理 第4部分：数据接口DB50-T 1096.4-2021

ICS65.020.30CCSB40

DB50重 庆 市 地 方 标 准DB50/T1096.4—202142021-03-30发布 2021-07-01实施重庆市市场监督管理局 发布DB50/T1096.4DB50/T1096.4—2021II前  言本文件按照GB/T1.1—20201本文件是DB50/T1096的第4部分。DB50/T1096已发布了以下部分：第1部分：总则第2部分：元数据第3部分：信息分类与编码第4部分：数据接口第5部分：共享交换技术要求第6部分：信息资源目录第7部分：管理要求请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由重庆市农业农村委员会提出并归口。本文件起草单位：重庆市畜牧技术推广总站、重庆大学、广州中科易德科技有限公司、西南大学、广州中国科学院软件应用技术研究所。DB50/T1096.4DB50/T1096.4—2021PAGEPAGE4畜牧兽医大数据应用与管理第4部分：数据接口范围本文件规定了畜牧兽医行业大数据中数据接口的术语、定义和缩略语，网络要求和接口协议。本文件适用于畜牧兽医云系统之间数据的对接与传输。规范性引用文件（包括所有的修改单适用于本文件。GB/T36345信息技术通用数据导入接口术语、定义和缩略语术语和定义下列术语和定义适用于本文件。3.1.1数据接口datainterface数据对接与传输过程中所需要的软硬件、网络环境及其在数据交换时需要符合的通信方式和要求。缩略语本文件中使用的缩略语如下：VPN：虚拟专用网（VirtualPrivateNetwork）TCP/IP：传输控制协议/网际协议（TransmissionControlProtocol/InternetProtocol）HTTP：超文本传输协议（HyperTextTransferProtocol）AES：高级加密标准（AdvancedEncryptionStandard）MD5：消息摘要算法第五版（Message-DigestAlgorithm5）CRC：循环冗余校验（CyclicRedundancyCheck）JSON：JS对象标记（JavaScriptObjectNotation）网络要求网络结构畜牧兽医云通过互联网与各级管理与服务系统交换数据、发起和应答指令，具体见图1。图1畜牧兽医云网络结构网络连接畜牧兽医云应具有固定IP地址、端口号，通过VPN与各级管理与服务系统实现连接。VPNVPN功能要求见表1。1VPN功能要求描述WEB应用加速对WEB访问资源的压缩身份认证支持短信认证、USBKEY认证单点登录支持单点登录备份功能支持本地和远程备份及恢复接口协议基本要求通信协议数据通信基于TCP/IP协议和HTTP协议，并符合GB/T36345的要求。包括以下情况：HTTP自动重连：各级管理与服务系统应定时向畜牧兽医云发送心跳数据包，并监测连接的状态，当监测到网络连接断开时，应自动重建连接；3次后，仍未收到回应，则认为通讯失败，应自动重建连接。超时时间可根据具体情况自行设定；5min数据安全畜牧兽医云数据传输使用AES加密；身份认证使用MD5校验。数据可靠性数据包中的实体数据使用CRC校验，其中实体数据的组成见图2。数据扩展性数据包中指令内容采用JSON格式，可新增字段支持后期扩展。接口协议数据结构数据包的组成2AES加密的JSON图2数据包的组成数据包的结构数据包的结构见表2。表2数据包的结构项目类型长度说明包头十六进制4字节固定为0x680x680x160x16实体数据总长度十六进制4字节代表当前数据包中的实体数据长度实体数据字符N字节（M+4）实体数据为数据包的实体内容。M含义见表3CRC校验十六进制2字节对实体数据进行CRC校验包尾十六进制4字节固定为0x550xAA0x550xAA实体数据的结构实体数据的结构见表3。表3实体数据的结构项目类型长度说明数据序列十六进制4字节标识了各级管理与服务系统向畜牧兽医云发送的数据序号，畜牧兽医云应答时，本项内容应按照各级管理与服务系统提供的数据序号进行填充。数据内容字符M字节根据数据序号，内容不同，数据内容是经过AES加密的JSON格式数据，加密后以ASCII码的格式进行传输。内容格式数据内容采用JSON格式，示例见图3。http://{SERVER_IP}/{SYTSTEM_NAME}/?http://{SERVER_IP}/{SYTSTEM_NAME}/?……Content-Type:application/json{"totalNum":1,"data":[{"P_OPERATION":"ADD","OBJID":"5CFC5CABA549CA9DE050A8C0DD01357A","GSZCH":null,"JYXM_DETAIL":"畜禽肉类产品销售","ZTYT_DET