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