DB50T 1096.5-2021 畜牧獸醫(yī)大數(shù)據(jù)應用與管理 第5部分：共享交換技術要求　　

ICS65.020.30CCSB40DB50重慶市市場監(jiān)督管理局發(fā)布DB50/T1096.5—2021本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件是DB50/T1096的第5部分。DB50/T1096已發(fā)布了以下部分：----第1部分：總則----第2部分：元數(shù)據(jù)----第3部分：信息分類與編碼----第4部分：數(shù)據(jù)接口----第5部分：共享交換技術要求----第6部分：信息資源目錄----第7部分：管理要求請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由重慶市農(nóng)業(yè)農(nóng)村委員會提出并歸口。本文件起草單位：重慶市畜牧技術推廣總站、重慶大學、廣州中科易德科技有限公司、西南大學、廣州中國科學院軟件應用技術研究所。本文件主要起草人：夏云霓、古平、李引、李曉波、陳紅躍、樊莉、張科、何道領、朱燕、黃文明、IDB50/T1096.5—2021畜牧獸醫(yī)大數(shù)據(jù)應用與管理第5部分：共享交換技術要求本文件規(guī)定了畜牧獸醫(yī)行業(yè)的數(shù)據(jù)共享與數(shù)據(jù)交換的技術要求。本文件適用于畜牧獸醫(yī)行業(yè)的數(shù)據(jù)共享與交換的具體實現(xiàn)。2規(guī)范性引用文件下列文件中的內容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件。不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時間表示法GB/T11457信息技術軟件工程術語GB/T20014.1良好農(nóng)業(yè)規(guī)范GB/T28167信息技術XML元數(shù)據(jù)交換（XMI）GB/T35295信息技術大數(shù)據(jù)術語GB/T38672信息技術大數(shù)據(jù)接口基本要求3術語、定義和縮略語3.1術語和定義下列術語和定義適用于本文件。3.1.1數(shù)據(jù)提供方dataprovider在數(shù)據(jù)共享與交換中提供數(shù)據(jù)的一方。3.1.2數(shù)據(jù)使用方datauser在數(shù)據(jù)共享與交換中接收并使用數(shù)據(jù)的一方。3.2縮略語本文件中使用的縮略語如下：JSON：JS對象標記（JavaScriptObjectNotation）HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）1DB50/T1096.5—2021MD5：消息摘要算法第五版（Message-DigestAlgorithm5）4數(shù)據(jù)共享與交換要求4.1數(shù)據(jù)共享要求數(shù)據(jù)共享應符合以下要求：a）數(shù)據(jù)共享以WEB服務方式提供，按照GB/T35295和GB/T38672的要求進行。b）數(shù)據(jù)共享服務的設計、封裝、開發(fā)按照GB/T11457和GB/T20014.1的要求進行。4.2數(shù)據(jù)交換方式數(shù)據(jù)交換按照GB/T7408和GB/T28167的要求進行，分為以下三個階段：a）數(shù)據(jù)使用方通過HTTP向數(shù)據(jù)提供方發(fā)起數(shù)據(jù)交換請求；b）數(shù)據(jù)提供方收到數(shù)據(jù)交換請求，解析數(shù)據(jù)報文，進行校驗后對合法數(shù)據(jù)進行發(fā)送，非法數(shù)據(jù)則發(fā)送錯誤代碼；c）數(shù)據(jù)使用方接收數(shù)據(jù)并存儲，返回一個數(shù)據(jù)報文，數(shù)據(jù)提供方根據(jù)返回數(shù)據(jù)報文判斷本次數(shù)據(jù)交換是否成功。4.3數(shù)據(jù)交換與內容格式數(shù)據(jù)交換的內容采用JSON作為數(shù)據(jù)交換的媒介,其格式應符合ECMAScript8.0的要求。4.4數(shù)據(jù)交換請求JSON格式4.4.1數(shù)據(jù)交換請求JSON應包含以下四個核心參數(shù)：a）accessToken：調用接口的令牌。登陸成功后，返回一個32位的Hash字符串；b）timestamp：接口使用方發(fā)出請求的客戶端時間（采用東八區(qū)系統(tǒng)時間UTC/GMT+08:00）；c）totalNum：表示數(shù)據(jù)交換所攜帶的記錄數(shù)量；d）data：為JSON數(shù)組，存放交換數(shù)據(jù)。4.4.2數(shù)據(jù)交換請求示例見附錄A。4.5數(shù)據(jù)交換返回JSON格式4.5.1數(shù)據(jù)交換返回結果JSON應包含以下四個核心參數(shù)：a）errorCode：為錯誤代碼，表明數(shù)據(jù)交換失敗的原因。當數(shù)據(jù)交換成功時，該參數(shù)為0；當數(shù)據(jù)交換失敗時，該參數(shù)為自定義的錯誤代碼；b）errorMessage：為返回結果信息，描述數(shù)據(jù)交換出錯的具體情況。當數(shù)據(jù)交換成功時，該參數(shù)為空值；當數(shù)據(jù)交換失敗時，該參數(shù)為自定義的錯誤原因；c）success：標志此次數(shù)據(jù)交換是否成功。成功為true，失敗為false；d）data：當數(shù)據(jù)交換成功時，則data參數(shù)為空值；當數(shù)據(jù)交換失敗時，data參數(shù)存放交換失敗的數(shù)據(jù)。4.5.2數(shù)據(jù)交換返回示例見附錄B和附錄C。4.6數(shù)據(jù)共享與交換安全2DB50/T1096.5—20214.6.1數(shù)據(jù)交換請求及數(shù)據(jù)交換返回中的data部分，均使用MD5加密方式進行加密。在數(shù)據(jù)交換時，數(shù)據(jù)發(fā)送方在傳輸數(shù)據(jù)的同時提供MD5碼，數(shù)據(jù)接收方接收后使用MD5碼對接收的數(shù)據(jù)進行驗證。4.6.2使用MD5加密的實現(xiàn)示例見附錄D。3DB50/T1096.5—2021附錄A數(shù)據(jù)交換請求JSON示例圖A.1給出了數(shù)據(jù)交換請求JSON示例。http://{SERVER_IP}/accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001&timeContent-Type:application/json{"ZTYT_DETAIL":"肉類銷售"JYCS":"重慶市九龍坡區(qū)白市驛鎮(zhèn)黃金橋"P_REGION_CODE":"440"P_LAST_UPDATE_TIME":"2017-11-0915:09:1"PERMIT_STATUS":"NOR"RCJDGLRY":"由負責日常監(jiān)督管理機構指"FZJG_DETAIL":"重慶市農(nóng)業(yè)執(zhí)法總"P_ID":"JY1440604011}圖A.1數(shù)據(jù)交換請求JSON示例4DB50/T1096.5—2021數(shù)據(jù)交換成功返回JSON示例圖B.1給出了數(shù)據(jù)交換成功返回JSON示例。{}",,圖B.1數(shù)據(jù)交換成功返回JSON示例5DB50/T1096.5—2021數(shù)據(jù)交換失敗返回JSON示例圖C.1給出了數(shù)據(jù)交換失敗返回JSON示例。{"errorMessage":"JSON數(shù)據(jù)驗證}圖C.1數(shù)據(jù)交換失敗返回JSON示例6DB50/T1096.5—2021MD5摘要JAVA實現(xiàn)示例圖D.1給出了MD5摘要JAVA實現(xiàn)示例。MessageDigestmd=MessageDigest.g