DB50T 1096.5-2021 畜牧兽医大数据应用与管理 第5部分：共享交换技术要求　　

ICS65.020.30CCSB40DB50重庆市市场监督管理局发布DB50/T1096.5—2021本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB50/T1096的第5部分。DB50/T1096已发布了以下部分：----第1部分：总则----第2部分：元数据----第3部分：信息分类与编码----第4部分：数据接口----第5部分：共享交换技术要求----第6部分：信息资源目录----第7部分：管理要求请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由重庆市农业农村委员会提出并归口。本文件起草单位：重庆市畜牧技术推广总站、重庆大学、广州中科易德科技有限公司、西南大学、广州中国科学院软件应用技术研究所。本文件主要起草人：夏云霓、古平、李引、李晓波、陈红跃、樊莉、张科、何道领、朱燕、黄文明、IDB50/T1096.5—2021畜牧兽医大数据应用与管理第5部分：共享交换技术要求本文件规定了畜牧兽医行业的数据共享与数据交换的技术要求。本文件适用于畜牧兽医行业的数据共享与交换的具体实现。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件。不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T11457信息技术软件工程术语GB/T20014.1良好农业规范GB/T28167信息技术XML元数据交换（XMI）GB/T35295信息技术大数据术语GB/T38672信息技术大数据接口基本要求3术语、定义和缩略语3.1术语和定义下列术语和定义适用于本文件。3.1.1数据提供方dataprovider在数据共享与交换中提供数据的一方。3.1.2数据使用方datauser在数据共享与交换中接收并使用数据的一方。3.2缩略语本文件中使用的缩略语如下：JSON：JS对象标记（JavaScriptObjectNotation）HTTP：超文本传输协议（HyperTextTransferProtocol）1DB50/T1096.5—2021MD5：消息摘要算法第五版（Message-DigestAlgorithm5）4数据共享与交换要求4.1数据共享要求数据共享应符合以下要求：a）数据共享以WEB服务方式提供，按照GB/T35295和GB/T38672的要求进行。b）数据共享服务的设计、封装、开发按照GB/T11457和GB/T20014.1的要求进行。4.2数据交换方式数据交换按照GB/T7408和GB/T28167的要求进行，分为以下三个阶段：a）数据使用方通过HTTP向数据提供方发起数据交换请求；b）数据提供方收到数据交换请求，解析数据报文，进行校验后对合法数据进行发送，非法数据则发送错误代码；c）数据使用方接收数据并存储，返回一个数据报文，数据提供方根据返回数据报文判断本次数据交换是否成功。4.3数据交换与内容格式数据交换的内容采用JSON作为数据交换的媒介,其格式应符合ECMAScript8.0的要求。4.4数据交换请求JSON格式4.4.1数据交换请求JSON应包含以下四个核心参数：a）accessToken：调用接口的令牌。登陆成功后，返回一个32位的Hash字符串；b）timestamp：接口使用方发出请求的客户端时间（采用东八区系统时间UTC/GMT+08:00）；c）totalNum：表示数据交换所携带的记录数量；d）data：为JSON数组，存放交换数据。4.4.2数据交换请求示例见附录A。4.5数据交换返回JSON格式4.5.1数据交换返回结果JSON应包含以下四个核心参数：a）errorCode：为错误代码，表明数据交换失败的原因。当数据交换成功时，该参数为0；当数据交换失败时，该参数为自定义的错误代码；b）errorMessage：为返回结果信息，描述数据交换出错的具体情况。当数据交换成功时，该参数为空值；当数据交换失败时，该参数为自定义的错误原因；c）success：标志此次数据交换是否成功。成功为true，失败为false；d）data：当数据交换成功时，则data参数为空值；当数据交换失败时，data参数存放交换失败的数据。4.5.2数据交换返回示例见附录B和附录C。4.6数据共享与交换安全2DB50/T1096.5—20214.6.1数据交换请求及数据交换返回中的data部分，均使用MD5加密方式进行加密。在数据交换时，数据发送方在传输数据的同时提供MD5码，数据接收方接收后使用MD5码对接收的数据进行验证。4.6.2使用MD5加密的实现示例见附录D。3DB50/T1096.5—2021附录A数据交换请求JSON示例图A.1给出了数据交换请求JSON示例。http://{SERVER_IP}/accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001&timeContent-Type:application/json{"ZTYT_DETAIL":"肉类销售"JYCS":"重庆市九龙坡区白市驿镇黄金桥"P_REGION_CODE":"440"P_LAST_UPDATE_TIME":"2017-11-0915:09:1"PERMIT_STATUS":"NOR"RCJDGLRY":"由负责日常监督管理机构指"FZJG_DETAIL":"重庆市农业执法总"P_ID":"JY1440604011}图A.1数据交换请求JSON示例4DB50/T1096.5—2021数据交换成功返回JSON示例图B.1给出了数据交换成功返回JSON示例。{}",,图B.1数据交换成功返回JSON示例5DB50/T1096.5—2021数据交换失败返回JSON示例图C.1给出了数据交换失败返回JSON示例。{"errorMessage":"JSON数据验证}图C.1数据交换失败返回JSON示例6DB50/T1096.5—2021MD5摘要JAVA实现示例图D.1给出了MD5摘要JAVA实现示例。MessageDigestmd=MessageDigest.g