畜牧獸醫(yī)大數(shù)據(jù)應(yīng)用與管理 第4部分：數(shù)據(jù)接口DB50-T 1096.4-2021

ICS65.020.30CCSB40

DB50重 慶 市 地 方 標(biāo) 準(zhǔn)DB50/T1096.4—202142021-03-30發(fā)布 2021-07-01實(shí)施重慶市市場(chǎng)監(jiān)督管理局 發(fā)布DB50/T1096.4DB50/T1096.4—2021II前??言本文件按照GB/T1.1—20201本文件是DB50/T1096的第4部分。DB50/T1096已發(fā)布了以下部分：第1部分：總則第2部分：元數(shù)據(jù)第3部分：信息分類與編碼第4部分：數(shù)據(jù)接口第5部分：共享交換技術(shù)要求第6部分：信息資源目錄第7部分：管理要求請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由重慶市農(nóng)業(yè)農(nóng)村委員會(huì)提出并歸口。本文件起草單位：重慶市畜牧技術(shù)推廣總站、重慶大學(xué)、廣州中科易德科技有限公司、西南大學(xué)、廣州中國(guó)科學(xué)院軟件應(yīng)用技術(shù)研究所。DB50/T1096.4DB50/T1096.4—2021PAGEPAGE4畜牧獸醫(yī)大數(shù)據(jù)應(yīng)用與管理第4部分：數(shù)據(jù)接口范圍本文件規(guī)定了畜牧獸醫(yī)行業(yè)大數(shù)據(jù)中數(shù)據(jù)接口的術(shù)語(yǔ)、定義和縮略語(yǔ)，網(wǎng)絡(luò)要求和接口協(xié)議。本文件適用于畜牧獸醫(yī)云系統(tǒng)之間數(shù)據(jù)的對(duì)接與傳輸。規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T36345信息技術(shù)通用數(shù)據(jù)導(dǎo)入接口術(shù)語(yǔ)、定義和縮略語(yǔ)術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1.1數(shù)據(jù)接口datainterface數(shù)據(jù)對(duì)接與傳輸過(guò)程中所需要的軟硬件、網(wǎng)絡(luò)環(huán)境及其在數(shù)據(jù)交換時(shí)需要符合的通信方式和要求?？s略語(yǔ)本文件中使用的縮略語(yǔ)如下：VPN：虛擬專用網(wǎng)（VirtualPrivateNetwork）TCP/IP：傳輸控制協(xié)議/網(wǎng)際協(xié)議（TransmissionControlProtocol/InternetProtocol）HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）AES：高級(jí)加密標(biāo)準(zhǔn)（AdvancedEncryptionStandard）MD5：消息摘要算法第五版（Message-DigestAlgorithm5）CRC：循環(huán)冗余校驗(yàn)（CyclicRedundancyCheck）JSON：JS對(duì)象標(biāo)記（JavaScriptObjectNotation）網(wǎng)絡(luò)要求網(wǎng)絡(luò)結(jié)構(gòu)畜牧獸醫(yī)云通過(guò)互聯(lián)網(wǎng)與各級(jí)管理與服務(wù)系統(tǒng)交換數(shù)據(jù)、發(fā)起和應(yīng)答指令，具體見(jiàn)圖1。圖1畜牧獸醫(yī)云網(wǎng)絡(luò)結(jié)構(gòu)網(wǎng)絡(luò)連接畜牧獸醫(yī)云應(yīng)具有固定IP地址、端口號(hào)，通過(guò)VPN與各級(jí)管理與服務(wù)系統(tǒng)實(shí)現(xiàn)連接。VPNVPN功能要求見(jiàn)表1。1VPN功能要求描述WEB應(yīng)用加速對(duì)WEB訪問(wèn)資源的壓縮身份認(rèn)證支持短信認(rèn)證、USBKEY認(rèn)證單點(diǎn)登錄支持單點(diǎn)登錄備份功能支持本地和遠(yuǎn)程備份及恢復(fù)接口協(xié)議基本要求通信協(xié)議數(shù)據(jù)通信基于TCP/IP協(xié)議和HTTP協(xié)議，并符合GB/T36345的要求。包括以下情況：HTTP自動(dòng)重連：各級(jí)管理與服務(wù)系統(tǒng)應(yīng)定時(shí)向畜牧獸醫(yī)云發(fā)送心跳數(shù)據(jù)包，并監(jiān)測(cè)連接的狀態(tài)，當(dāng)監(jiān)測(cè)到網(wǎng)絡(luò)連接斷開(kāi)時(shí)，應(yīng)自動(dòng)重建連接；3次后，仍未收到回應(yīng)，則認(rèn)為通訊失敗，應(yīng)自動(dòng)重建連接。超時(shí)時(shí)間可根據(jù)具體情況自行設(shè)定；5min數(shù)據(jù)安全畜牧獸醫(yī)云數(shù)據(jù)傳輸使用AES加密；身份認(rèn)證使用MD5校驗(yàn)。數(shù)據(jù)可靠性數(shù)據(jù)包中的實(shí)體數(shù)據(jù)使用CRC校驗(yàn)，其中實(shí)體數(shù)據(jù)的組成見(jiàn)圖2。數(shù)據(jù)擴(kuò)展性數(shù)據(jù)包中指令內(nèi)容采用JSON格式，可新增字段支持后期擴(kuò)展。接口協(xié)議數(shù)據(jù)結(jié)構(gòu)數(shù)據(jù)包的組成2AES加密的JSON圖2數(shù)據(jù)包的組成數(shù)據(jù)包的結(jié)構(gòu)數(shù)據(jù)包的結(jié)構(gòu)見(jiàn)表2。表2數(shù)據(jù)包的結(jié)構(gòu)項(xiàng)目類型長(zhǎng)度說(shuō)明包頭十六進(jìn)制4字節(jié)固定為0x680x680x160x16實(shí)體數(shù)據(jù)總長(zhǎng)度十六進(jìn)制4字節(jié)代表當(dāng)前數(shù)據(jù)包中的實(shí)體數(shù)據(jù)長(zhǎng)度實(shí)體數(shù)據(jù)字符N字節(jié)（M+4）實(shí)體數(shù)據(jù)為數(shù)據(jù)包的實(shí)體內(nèi)容。M含義見(jiàn)表3CRC校驗(yàn)十六進(jìn)制2字節(jié)對(duì)實(shí)體數(shù)據(jù)進(jìn)行CRC校驗(yàn)包尾十六進(jìn)制4字節(jié)固定為0x550xAA0x550xAA實(shí)體數(shù)據(jù)的結(jié)構(gòu)實(shí)體數(shù)據(jù)的結(jié)構(gòu)見(jiàn)表3。表3實(shí)體數(shù)據(jù)的結(jié)構(gòu)項(xiàng)目類型長(zhǎng)度說(shuō)明數(shù)據(jù)序列十六進(jìn)制4字節(jié)標(biāo)識(shí)了各級(jí)管理與服務(wù)系統(tǒng)向畜牧獸醫(yī)云發(fā)送的數(shù)據(jù)序號(hào)，畜牧獸醫(yī)云應(yīng)答時(shí)，本項(xiàng)內(nèi)容應(yīng)按照各級(jí)管理與服務(wù)系統(tǒng)提供的數(shù)據(jù)序號(hào)進(jìn)行填充。數(shù)據(jù)內(nèi)容字符M字節(jié)根據(jù)數(shù)據(jù)序號(hào)，內(nèi)容不同，數(shù)據(jù)內(nèi)容是經(jīng)過(guò)AES加密的JSON格式數(shù)據(jù)，加密后以ASCII碼的格式進(jìn)行傳輸。內(nèi)容格式數(shù)據(jù)內(nèi)容采用JSON格式，示例見(jiàn)圖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":"畜禽肉類產(chǎn)品銷售","ZTYT_DET