T-SCA 024-2023 冷藏集裝箱智能監(jiān)控通.用信息平臺(tái)建設(shè)指南

ICS55.180.10CCSA85SCA南ConstructionguidelineofsmartmonitoringgeneralinformationplatformofrefrigerationcontainerIT/SCA024—2023前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5平臺(tái)功能 26平臺(tái)對(duì)外接口 37數(shù)據(jù)安全 3附錄A（資料性）5類接口格式 4T/SCA024—2023本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。本文件由深圳市智能集裝箱技術(shù)協(xié)會(huì)提出和歸口。本文件起草單位：中國質(zhì)量認(rèn)證中心、深圳市智能集裝箱技術(shù)協(xié)會(huì)、廣東科貿(mào)職業(yè)學(xué)院、深圳中集智能科技有限公司、深圳市標(biāo)準(zhǔn)技術(shù)研究院、交通運(yùn)輸部水運(yùn)科學(xué)研究院、湘潭大學(xué)、深圳技術(shù)大學(xué)、廣州鐵路職業(yè)技術(shù)學(xué)院、中鐵集裝箱運(yùn)輸有限責(zé)任公司、深圳中集移動(dòng)物聯(lián)國際運(yùn)營服務(wù)有限公司。本文件主要起草人：鄭涓、周受欽、楊小明、呂潔印、張平、李媛紅、劉浩、羅宇民、李繼春、張旭杰、易曉珊、陳雷、楊海霞、史立坤、錢英軍、雷高攀、陳國芬、周世平、李翀宇、劉冰。1T/SCA024—2023冷藏集裝箱智能監(jiān)控通用信息平臺(tái)建設(shè)指南本文件規(guī)定了冷藏集裝箱智能監(jiān)控系統(tǒng)通用信息平臺(tái)的功能、接口和數(shù)據(jù)安全。本文件適用于冷藏集裝箱智能監(jiān)控系統(tǒng)通用信息平臺(tái)的建設(shè)。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1冷藏集裝箱智能監(jiān)控系統(tǒng)smartmonitoringsystemofrefrigerationcontainer一種利用先進(jìn)的技術(shù)手段對(duì)冷藏集裝箱進(jìn)行實(shí)時(shí)數(shù)據(jù)監(jiān)控和管理的物聯(lián)網(wǎng)系統(tǒng)，包括冷藏集裝箱智能監(jiān)控終端和冷藏集裝箱智能監(jiān)控信息平臺(tái)兩部分。3.2冷藏集裝箱智能監(jiān)控終端smartmonitoringterminalofrefrigerationcontainer安裝在冷藏集裝箱上，能對(duì)該集裝箱冷機(jī)狀態(tài)、送風(fēng)溫度、回風(fēng)溫度、濕度、位置等數(shù)據(jù)進(jìn)行自動(dòng)采集和監(jiān)測(cè)的裝置，該裝置能通過蜂窩網(wǎng)絡(luò)、Wi-Fi等無線方式將數(shù)據(jù)傳輸?shù)嚼洳丶b箱智能監(jiān)控信息3.3冷藏集裝箱智能監(jiān)控信息平臺(tái)smartmonitoringcloudplatformofrefrigerationcontainer負(fù)責(zé)接收、存儲(chǔ)和處理從冷藏集裝箱智能監(jiān)控終端采集的數(shù)據(jù)的信息平臺(tái)。用戶可以通過信息平臺(tái)實(shí)現(xiàn)對(duì)冷藏集裝箱的遠(yuǎn)程監(jiān)控和管理，包括實(shí)時(shí)監(jiān)控集裝箱的狀態(tài)、歷史數(shù)據(jù)回溯、異常情況報(bào)警等功3.4冷藏集裝箱refrigerationcontainer一種安裝有冷機(jī)，可以保持恒定溫度，以便運(yùn)輸過程中物品在恒定溫度下的集裝箱。4縮略語下列縮略語適用于本文件。JSON：對(duì)象標(biāo)記(javaScriptobjectnotation)HTTP：超文本傳輸協(xié)議（hypertexttransferprotocol）HTTPS:安全的超文本傳輸協(xié)議（hypertexttransferprotocolsecure）MQTT：消息隊(duì)列遙測(cè)傳輸（messagequeuingtelemetrytransport）MQTT-SN：MQTT協(xié)議的傳感器版本（MQTTForsensornetworks）Restful:REST（英文：representationalstatetransfer，簡(jiǎn)稱REST)，指的是一組架構(gòu)約束條件和原則。符合REST設(shè)計(jì)風(fēng)格的WebAPI稱為RESTfulAPI。它從以下三個(gè)方面資源進(jìn)行定義：直觀簡(jiǎn)短2T/SCA024—2023的資源地址：URI，比如：/resources/。傳輸?shù)馁Y源：Web服務(wù)接受與返回的互聯(lián)網(wǎng)媒體類型，比如：JSON，XML，YAM等。對(duì)資源的操作：Web服務(wù)在該資源上所支持的一系列請(qǐng)求方法（比如：POST，GET，PUT或DELETE）。TCP：傳輸控制協(xié)議（transmissioncontrolprotocol）UDP：用戶數(shù)據(jù)報(bào)協(xié)議（userdatagramprotocol）5平臺(tái)功能5.1一般要求5.1.1冷藏集裝箱智能監(jiān)控系統(tǒng)通用信息平臺(tái)應(yīng)具備實(shí)時(shí)數(shù)據(jù)、歷史數(shù)據(jù)、事件數(shù)據(jù)、集裝箱管理、設(shè)備管理、用戶管理、角色管理、多層級(jí)管理等基礎(chǔ)功能，以及數(shù)據(jù)采集、數(shù)據(jù)處理、數(shù)據(jù)發(fā)布、數(shù)據(jù)接收、數(shù)據(jù)存儲(chǔ)、數(shù)據(jù)分發(fā)、數(shù)據(jù)交互和數(shù)據(jù)安全管理等功能。5.1.2數(shù)據(jù)保存時(shí)間不少于2年。5.1.3應(yīng)具備以下數(shù)據(jù)管理功能：a)支持按用戶、層級(jí)、設(shè)備類型等參數(shù)對(duì)數(shù)據(jù)進(jìn)行權(quán)限控制、數(shù)據(jù)處理、數(shù)據(jù)分析等；b)支持按用戶、層級(jí)、設(shè)備類型、設(shè)備編號(hào)、箱號(hào)、時(shí)間等參數(shù)將數(shù)據(jù)分發(fā)或發(fā)布到第三方平臺(tái)或從第三方平臺(tái)采集數(shù)據(jù)等數(shù)據(jù)交互功能；c)支持與工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析體系對(duì)接。5.2數(shù)據(jù)管理5.2.1實(shí)時(shí)數(shù)據(jù)平臺(tái)具備對(duì)當(dāng)前在線冷藏集裝箱的箱號(hào)、數(shù)據(jù)時(shí)間、位置、靜止時(shí)長、送風(fēng)溫度、回風(fēng)溫度、設(shè)定溫度、濕度、電池電量、冷機(jī)狀態(tài)、分組等數(shù)據(jù)進(jìn)行實(shí)時(shí)展示功能；同時(shí)支持按箱號(hào)、數(shù)據(jù)時(shí)間、分組、狀態(tài)等字段進(jìn)行數(shù)據(jù)檢索。支持在GIS地圖顯示位置等信息。5.2.2歷史數(shù)據(jù)平臺(tái)具備以時(shí)間順序按箱號(hào)、時(shí)間范圍對(duì)冷藏集裝箱的歷史數(shù)據(jù)進(jìn)行展示，展示數(shù)據(jù)應(yīng)包括冷藏集裝箱的箱號(hào)、數(shù)據(jù)時(shí)間、位置、靜止時(shí)長、送風(fēng)溫度、回風(fēng)溫度、設(shè)定溫度、濕度、電池電量、冷機(jī)狀態(tài)、分組等數(shù)據(jù)字段。5.2.3事件數(shù)據(jù)平臺(tái)應(yīng)具備事件數(shù)據(jù)設(shè)置功能與處理功能，事件數(shù)據(jù)應(yīng)包括事件名稱、事件類型、觸發(fā)閾值等。上報(bào)事件數(shù)據(jù)的內(nèi)容應(yīng)包括冷藏集裝箱的箱號(hào)、時(shí)間、事件名稱、事件類型、觸發(fā)閾值、報(bào)警值等。5.3設(shè)備管理5.3.1集裝箱管理平臺(tái)應(yīng)具備集裝箱管理功能，支持添加、刪除、修改集裝箱信息，設(shè)置集裝箱所屬層級(jí)和分組等。5.3.2設(shè)備管理平臺(tái)應(yīng)具備設(shè)備管理功能，支持添加、刪除、修改設(shè)備信息，設(shè)置設(shè)備所屬層級(jí)和分組等。5.4平臺(tái)權(quán)限管理5.4.1用戶管理平臺(tái)應(yīng)具備用戶賬號(hào)管理功能，支持開設(shè)子賬號(hào)，給賬號(hào)賦予菜單權(quán)限和數(shù)據(jù)層級(jí)的權(quán)限。5.4.2角色管理平臺(tái)應(yīng)具備角色設(shè)置功能。支持設(shè)置超級(jí)管理員、普通管理員、一般操作用戶和其他用戶角色等。5.4.3多層級(jí)管理3T/SCA024—2023平臺(tái)應(yīng)具備多層級(jí)設(shè)置功能。支持對(duì)集裝箱、設(shè)備的多層級(jí)管理。6平臺(tái)對(duì)外接口6.1數(shù)據(jù)獲取方式冷藏集裝箱智能監(jiān)控通用信息平臺(tái)應(yīng)具備HttpRESTful接口，采用Https協(xié)議，數(shù)據(jù)采用JSON格式，數(shù)據(jù)編碼采用UTF-8，日期時(shí)間采用國際標(biāo)準(zhǔn)時(shí)間(UTC格式為YYYY-MM-DDHH:MI:SS（年-月-日時(shí):分:秒)。6.2API接口格式6.2.1冷藏集裝箱智能監(jiān)控通用信息平臺(tái)應(yīng)具備標(biāo)準(zhǔn)API接口，與第三方平臺(tái)進(jìn)行對(duì)接、集成。6.2.2按照RESTful接口規(guī)范，平臺(tái)分為5類接口：a)GET接口：用于獲取資源，改接口不能對(duì)數(shù)據(jù)進(jìn)行修改；b)POST接口：用于創(chuàng)建新資源；c)PUT接口：用于替換原有的資源；d)PATCH接口：用于修改已存在的資源，特別是修改資源的部分?jǐn)?shù)據(jù)；e)DELETE接口：用于刪除已有的資源。注：5類接口格式見附錄A。6.2.3http狀態(tài)代碼規(guī)定如下：a)1xx(提示類）：請(qǐng)求被接收到，正在處理；b)2xx(成功類）：請(qǐng)求被接收到，被理解和成功處理；c)3xx(重定向類)：為完成這個(gè)請(qǐng)求，需要進(jìn)一步的操作進(jìn)行處理；d)4xx(客戶端異常類）：客戶端發(fā)送的字符串不合法或無法被后端解析；e)5xx(服務(wù)端異常類)：服務(wù)端出現(xiàn)錯(cuò)誤而無法進(jìn)行處理。6.3API接口功能冷藏集裝箱智能監(jiān)控通用信息平臺(tái)應(yīng)至少具備以下API接口功能：a)用戶登錄：采用POST接口，用于驗(yàn)證用戶憑證并完成登錄操作；b)用戶注冊(cè)：采用POST接口，用于創(chuàng)建新用戶賬號(hào)；c)用戶權(quán)限獲?。翰捎肎ET接口，用于獲取用戶權(quán)限信息；d)智能監(jiān)控設(shè)備管理；設(shè)備的新增采用POST接口，修改采用PUT和PATCH接口，刪除采用DELETE接口；e)冷藏集裝箱管理：集裝箱的新增采用POST接口，集裝箱修改采用PUT和PATCH接口，集裝箱刪除采用DELETE接口；f)獲取實(shí)時(shí)數(shù)據(jù)：采用GET接口；g)獲取歷史數(shù)據(jù)：采用GET接口；h)獲取事件數(shù)據(jù)：采用GET接口。7數(shù)據(jù)安全冷藏集裝箱智能監(jiān)控通用信息平臺(tái)應(yīng)具備基本的數(shù)據(jù)安全防護(hù)能力，支持?jǐn)?shù)字簽名、數(shù)字證書和數(shù)據(jù)加密傳輸?shù)裙δ?。平臺(tái)安全防護(hù)等級(jí)宜達(dá)到GB/T22239中規(guī)定的安全等級(jí)三級(jí)要求。4T/SCA024—2023（資料性）5類接口格式A.1GET/DELTE接口格式GET/DELTE接口格式如下：訪問路徑：/{平臺(tái)英文縮寫名稱}/api/{版本號(hào)}/{類名稱}/{資源名稱}?參數(shù)1=參數(shù)1值&參數(shù)2=參數(shù)2值......請(qǐng)求方式：GET/DELTE請(qǐng)求參數(shù)：放入Http請(qǐng)求路徑和請(qǐng)求參數(shù)中。如采用加密處理，則Http請(qǐng)求參數(shù)內(nèi)容為