(高清版)GBT 42569-2023 工業(yè)互聯(lián)網(wǎng)平臺(tái) 開放應(yīng)用編程接口功能要求

工業(yè)互聯(lián)網(wǎng)平臺(tái)開放應(yīng)用編程接口功能要求2023-05-23發(fā)布國家市場監(jiān)督管理總局國家標(biāo)準(zhǔn)化管理委員會(huì) I 2規(guī)范性引用文件 3術(shù)語和定義 4開放應(yīng)用編程接口 24.1接口框架 4.2工業(yè)應(yīng)用接口 4.3工業(yè)裝備接口 4.4工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口 5工業(yè)應(yīng)用接口要求 5.1資源管理類接口 5.2數(shù)據(jù)操作類接口 5.3安全輔助類接口 35.4應(yīng)用管理類接口 5.5支撐服務(wù)類接口 5.6運(yùn)維管理類接口 46工業(yè)裝備接口要求 6.1接入管理類接口 6.2監(jiān)控管理類接口 6.3數(shù)據(jù)管理類接口 56.4安全輔助類接口 6.5運(yùn)維管理類接口 7工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口要求 57.1互通管理類接口 57.2數(shù)據(jù)操作類接口 7.3安全輔助類接口 7.4運(yùn)維管理類接口 參考文獻(xiàn) I本文件按照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ù)標(biāo)準(zhǔn)化技術(shù)委員會(huì)(SAC/TC28)提出并歸口。本文件起草單位：中國電子技術(shù)標(biāo)準(zhǔn)化研究院、網(wǎng)絡(luò)通信與安全紫金山實(shí)驗(yàn)室、浪潮云信息技術(shù)股份公司、合肥斯歐互聯(lián)科技股份有限公司、國電南京自動(dòng)化股份有限公司、江蘇方天電力技術(shù)有限公司、山東未來集團(tuán)有限公司、中汽研汽車工業(yè)工程(天津)有限公司、江蘇亨通智能裝備有限公司、四川長虹電子控股集團(tuán)有限公司、襄陽光瑞汽車零部件有限公司、甌星機(jī)械設(shè)備有限公司、貴州航天云網(wǎng)科技有限公司、中航電測儀器(西安)有限公司、北京力控元通科技有限公司、潤聯(lián)智能科技股份有限公司、濰坊北大青鳥華光照排有限公司、東南大學(xué)、深圳華制智能制造技術(shù)有限公司、青島孚鼎泰智能技術(shù)有限公司、貴州大學(xué)、青島中瑞汽車服務(wù)有限公司、甘肅銀光化學(xué)工業(yè)集團(tuán)有限公司、中移(蘇州)軟件技術(shù)有限公司、天津融和互聯(lián)高新技術(shù)股份有限公司、蘇州協(xié)同創(chuàng)新智能制造裝備有限公司、安徽邁立信息科技有限公司、深圳融昕醫(yī)療科技有限公司、北京華勝天成科技股份有限公司、卡奧斯工業(yè)智能研究院(青島)有限公司。本文件主要起草人：陳志峰、王志鵬、陳平平、張敏、王照陽、于萬欽、尹飛、徐小傳、韋安壘、門峰、楊凌崗。1工業(yè)互聯(lián)網(wǎng)平臺(tái)開放應(yīng)用編程接口功能要求1范圍本文件確立了工業(yè)互聯(lián)網(wǎng)平臺(tái)開放應(yīng)用編程接口框架，規(guī)定了接口的功能要求。本文件適用于工業(yè)互聯(lián)網(wǎng)平臺(tái)或工業(yè)應(yīng)用的開發(fā)方、使用方及第三方組織對(duì)工業(yè)互聯(lián)網(wǎng)平臺(tái)和接口開展設(shè)計(jì)、開發(fā)及測試評(píng)估工作。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T11457—2006信息技術(shù)軟件工程術(shù)語3術(shù)語和定義GB/T11457—2006界定的以及下列術(shù)語和定義適用于本文件。面向制造業(yè)數(shù)字化、網(wǎng)絡(luò)化、智能化需求，構(gòu)建基于云平臺(tái)的海量數(shù)據(jù)采集、匯聚和分析服務(wù)，支撐制造資源廣泛連接、彈性供給、高效配置的系統(tǒng)。開放應(yīng)用編程接口openapplicationprogramminginterface提供應(yīng)用軟件、裝備和互聯(lián)網(wǎng)平臺(tái)間的操作、接入能力，為互聯(lián)網(wǎng)平臺(tái)的使用資源實(shí)現(xiàn)信息融合、信息交換和信息共享的接口。數(shù)據(jù)模型datamodel一種針對(duì)工業(yè)裝備采集數(shù)據(jù)配置的模型。注：通過配置的數(shù)據(jù)模型完成數(shù)據(jù)的清洗、轉(zhuǎn)換、加工。模型一般由工藝參數(shù)、工況參數(shù)、能耗參數(shù)構(gòu)成。處理模型processingmodel實(shí)現(xiàn)工業(yè)裝備的數(shù)據(jù)采集，對(duì)采集數(shù)據(jù)按照模型中配置的信息實(shí)現(xiàn)邏輯運(yùn)算，通過邏輯運(yùn)算完成數(shù)據(jù)清洗、數(shù)據(jù)加工、感知計(jì)算、事件告警和規(guī)則計(jì)算處理。工業(yè)數(shù)據(jù)存儲(chǔ)和計(jì)算、工業(yè)協(xié)議解析和轉(zhuǎn)換的軟硬件系統(tǒng)或裝置，用于建立工業(yè)裝備與工業(yè)互聯(lián)網(wǎng)平臺(tái)間的連接。24開放應(yīng)用編程接口4.1接口框架工業(yè)互聯(lián)網(wǎng)平臺(tái)開放應(yīng)用編程接口指用于管控工業(yè)應(yīng)用、工業(yè)裝備，并為其他工業(yè)互聯(lián)網(wǎng)平臺(tái)提供能力的接口。開放應(yīng)用編程接口要求，用于指導(dǎo)開展工業(yè)應(yīng)用、工業(yè)裝備和工業(yè)互聯(lián)網(wǎng)平臺(tái)間的互聯(lián)互通、互操作接口設(shè)計(jì)、開發(fā)及測試評(píng)估工作。開放應(yīng)用編程接口包括：工業(yè)應(yīng)用接口、工業(yè)裝備接口和工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口。工業(yè)互聯(lián)網(wǎng)平臺(tái)開放應(yīng)用編程接口框架見圖1。其中，工業(yè)應(yīng)用接口為工業(yè)應(yīng)用及其開發(fā)者提供了工業(yè)應(yīng)用開發(fā)過程中所需的資源、數(shù)據(jù)及支撐服務(wù)的訪問及操作的能力；工業(yè)裝備接口為工業(yè)裝備及其開發(fā)者提供了工業(yè)裝備的接入、監(jiān)控、配置、運(yùn)維的能力；工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口為工業(yè)應(yīng)用及其開發(fā)者提供了平臺(tái)間互聯(lián)、互通、互操作的能力；“……”為與工業(yè)裝備接口處于同一層級(jí)包括如資源與能力接口等在內(nèi)的其他接入工業(yè)互聯(lián)網(wǎng)平臺(tái)的接口。工業(yè)應(yīng)用工業(yè)應(yīng)用接口工業(yè)互聯(lián)網(wǎng)平臺(tái)工業(yè)互聯(lián)錯(cuò)工業(yè)互聯(lián)網(wǎng)平臺(tái)工業(yè)裝備接口……工業(yè)裝備圖1工業(yè)互聯(lián)網(wǎng)平臺(tái)開放應(yīng)用編程接口框架4.2工業(yè)應(yīng)用接口工業(yè)應(yīng)用接口應(yīng)包含：a)資源管理類接口；b)數(shù)據(jù)操作類接口；c)安全輔助類接口；d)應(yīng)用管理類接口；e)支撐服務(wù)類接口；f)運(yùn)維管理類接口。4.3工業(yè)裝備接口工業(yè)裝備接口應(yīng)包含：a)接入管理類接口；b)監(jiān)控管理類接口；c)數(shù)據(jù)管理類接口；3d)安全輔助類接口；e)運(yùn)維管理類接口。4.4工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口應(yīng)包含：a)互通管理類接口；b)數(shù)據(jù)操作類接口；c)安全輔助類接口；d)運(yùn)維管理類接口。5工業(yè)應(yīng)用接口要求5.1資源管理類接口資源管理類接口應(yīng)：a)提供對(duì)計(jì)算資源、存儲(chǔ)資源、網(wǎng)絡(luò)資源的申請(qǐng)功能；b)提供對(duì)已申請(qǐng)資源的使用功能；c)提供對(duì)已注銷資源的釋放功能；d)提供對(duì)運(yùn)行中資源的監(jiān)控功能。5.2數(shù)據(jù)操作類接口數(shù)據(jù)操作類接口應(yīng)：a)針對(duì)不同的數(shù)據(jù)存儲(chǔ)要求，提供全量、增量的寫入功能；b)依據(jù)業(yè)務(wù)處理要求，對(duì)狀態(tài)變更的數(shù)據(jù)提供逐條、批量的邏輯刪除功能；c)在過程數(shù)據(jù)發(fā)生變更時(shí)，提供滿足不同結(jié)構(gòu)數(shù)據(jù)的全量、增量更新功能；d)對(duì)各種結(jié)構(gòu)化數(shù)據(jù)、非結(jié)構(gòu)化數(shù)據(jù)和半結(jié)構(gòu)化數(shù)據(jù)的讀取查詢功能；e)針對(duì)報(bào)表呈現(xiàn)的數(shù)據(jù)要求，提供業(yè)務(wù)數(shù)據(jù)的統(tǒng)計(jì)分析功能。5.3安全輔助類接口安全輔助類接口應(yīng)：a)具備驗(yàn)證用戶真實(shí)身份和權(quán)限范圍的能力；b)具備訪問速率限制、訪問次數(shù)限制及峰值保護(hù)等能力；c)對(duì)具有寫入權(quán)限的接口，提供驗(yàn)證輸入、輸出內(nèi)容的能力；d)具備安全審計(jì)功能，如，訪問異常檢測能力、接口訪問行為檢測能力等；e)接口鑒權(quán)應(yīng)具備時(shí)效性，對(duì)于異常訪問應(yīng)限制最高錯(cuò)誤次數(shù)。5.4應(yīng)用管理類接口應(yīng)用管理類接口應(yīng)提供：配置和應(yīng)用發(fā)布；b)應(yīng)用操作功能，對(duì)已創(chuàng)建的應(yīng)和實(shí)例銷毀；c)應(yīng)用關(guān)聯(lián)功能，對(duì)應(yīng)用實(shí)例關(guān)聯(lián)的數(shù)據(jù)源和服務(wù)提供綁定與解除綁定的功能；d)應(yīng)用監(jiān)控功能，實(shí)現(xiàn)對(duì)運(yùn)行的應(yīng)用進(jìn)行監(jiān)控，包括運(yùn)行狀態(tài)、會(huì)話控制、異常告警、日志審計(jì)和閾值監(jiān)控。45.5支撐服務(wù)類接口支撐服務(wù)類接口應(yīng)提供第三方支撐服務(wù)的操作能力，支撐服務(wù)類接口提供的服務(wù)應(yīng)包括但不限于：a)消息隊(duì)列服務(wù)支持：b)算法服務(wù)支持：1)算法服務(wù)實(shí)例創(chuàng)建、銷毀和狀態(tài)查詢功能；2)算法服務(wù)模型聲明及服務(wù)調(diào)用的功能。c)數(shù)據(jù)庫服務(wù)支持：1)數(shù)據(jù)庫實(shí)例的創(chuàng)建、修改、銷毀的功能；4)實(shí)例運(yùn)行時(shí)監(jiān)控的能力，以及配置數(shù)據(jù)集權(quán)限的功能。5.6運(yùn)維管理類接口運(yùn)維管理類接口：a)應(yīng)針對(duì)已有應(yīng)用實(shí)例，提供備份與遷移、快速恢復(fù)、應(yīng)用重啟等功能；b)應(yīng)實(shí)現(xiàn)應(yīng)用依賴的各種數(shù)據(jù)結(jié)構(gòu)的數(shù)據(jù)備份，按照時(shí)間節(jié)點(diǎn)或業(yè)務(wù)要求進(jìn)行的數(shù)據(jù)恢復(fù)功能；c)應(yīng)按照數(shù)據(jù)存儲(chǔ)時(shí)間周期，定期實(shí)現(xiàn)數(shù)據(jù)的清理或遷移功能；d)應(yīng)具備數(shù)據(jù)操作、傳輸日志的記錄功能，并提供數(shù)據(jù)存儲(chǔ)的能力；e)可具備應(yīng)用實(shí)例的異常診斷及其自恢復(fù)功能。6工業(yè)裝備接口要求6.1接入管理類接口接入管理類接口應(yīng)滿足如下要求：a)支持工業(yè)裝備直連接入，包括：1)具備工業(yè)裝備識(shí)別能力，提供工業(yè)裝備識(shí)別、鑒權(quán)功能，根據(jù)預(yù)設(shè)規(guī)則主動(dòng)掃描網(wǎng)絡(luò)內(nèi)待接入裝備并建立接入連接；2)具備工業(yè)裝備注冊(cè)能力，提供工業(yè)裝備鑒權(quán)及信息收集功能；3)具備工業(yè)裝備接入復(fù)位能力，提供快速恢復(fù)前次配置的功能。b)支持工業(yè)裝備網(wǎng)關(guān)類產(chǎn)品接入，包括：1)具備工業(yè)裝備網(wǎng)關(guān)識(shí)別能力，提供工業(yè)裝備網(wǎng)關(guān)的識(shí)別、鑒權(quán)功能，可根據(jù)預(yù)設(shè)規(guī)則主動(dòng)掃描工業(yè)裝備網(wǎng)關(guān)并建立接入連接；2)具備工業(yè)裝備網(wǎng)關(guān)注冊(cè)能力，提供工業(yè)裝備網(wǎng)關(guān)的鑒權(quán)及信息收集功能；3)具備工業(yè)裝備網(wǎng)關(guān)接入復(fù)位能力，提供快速恢復(fù)前次配置的功能。6.2監(jiān)控管理類接口監(jiān)控管理類接口功能包括：a)應(yīng)支持監(jiān)控工業(yè)裝備的綜合利用信息、故障信息、計(jì)劃時(shí)間、平均故障間隔期和有效生產(chǎn)數(shù)據(jù)b)應(yīng)支持監(jiān)控工業(yè)裝備的工況狀態(tài)；5d)應(yīng)支持監(jiān)控工業(yè)裝備的生產(chǎn)數(shù)據(jù)；e)應(yīng)支持監(jiān)控工業(yè)裝備的異常信息、報(bào)警事件；f)可支持監(jiān)控工業(yè)裝備網(wǎng)絡(luò)狀況。6.3數(shù)據(jù)管理類接口數(shù)據(jù)管理類接口功能應(yīng)：1)具備對(duì)于幾何模型、物理特征、數(shù)據(jù)模型和處理模型的建模功能；2)支持模型變更，根據(jù)工業(yè)裝備信息的變化，對(duì)幾何模型、物理特征、數(shù)據(jù)模型和處理模型的數(shù)據(jù)進(jìn)行同步變更；3)支持模型移除，將取消或棄用的模型進(jìn)行移除操作。1)支持?jǐn)?shù)據(jù)獲取，獲取裝備的注冊(cè)臺(tái)賬信息、裝備運(yùn)行狀態(tài)信息和裝備生產(chǎn)工藝信息；2)支持?jǐn)?shù)據(jù)解析，提供識(shí)別裝備采集數(shù)據(jù)的能力，實(shí)現(xiàn)數(shù)據(jù)解析；3)支持?jǐn)?shù)據(jù)加工，提供支持?jǐn)?shù)據(jù)采集的邊緣計(jì)算能力，基于數(shù)據(jù)模型和處理模型中的配置信息，對(duì)已采集的數(shù)據(jù)進(jìn)行清洗、轉(zhuǎn)換及規(guī)則感知計(jì)算等處理；4)支持?jǐn)?shù)據(jù)存儲(chǔ)，將經(jīng)加工處理的數(shù)據(jù)寫入工業(yè)互聯(lián)網(wǎng)平臺(tái)進(jìn)行持久化存儲(chǔ)。c)支持命令下發(fā)，包括：1)支持裝備控制，接收裝備運(yùn)行控制命令，下發(fā)裝備運(yùn)行控制命令至工業(yè)裝備；2)支持固件升級(jí)，為固件程序提供版本升級(jí)功能。6.4安全輔助類接口安全輔助類接口功能應(yīng)包括：a)提供對(duì)工業(yè)裝備接入進(jìn)行身份鑒別的功能；b)提供通信鏈路加密功能，實(shí)現(xiàn)對(duì)工業(yè)裝備上行數(shù)據(jù)和下行數(shù)據(jù)的安全防護(hù)；c)提供非可逆算法生成會(huì)話簽名，保障通信通道鏈路中傳輸?shù)男畔⒉槐淮鄹幕蚋`?。籨)支持預(yù)設(shè)通信鏈路的會(huì)話時(shí)間，降低工業(yè)裝備接口被攻擊/仿冒的風(fēng)險(xiǎn)；e)提供支持工業(yè)裝備終端敏感數(shù)據(jù)的脫敏功能，實(shí)現(xiàn)安全啟動(dòng)和安全能力升級(jí)。6.5運(yùn)維管理類接口運(yùn)維管理類接口功能包括：a)應(yīng)支持工業(yè)裝備的工單操作，記錄處理工單的過程信息；b)應(yīng)支持對(duì)工業(yè)裝備采集的數(shù)據(jù)進(jìn)行定期維護(hù)，實(shí)現(xiàn)定時(shí)、定量的數(shù)據(jù)清理與遷移；c)可支持通過對(duì)工業(yè)裝備工況信息的數(shù)據(jù)分析，實(shí)現(xiàn)為工業(yè)裝備預(yù)測性維護(hù)提供數(shù)據(jù)支撐；d)應(yīng)支持通過對(duì)工業(yè)裝備的日常巡檢和點(diǎn)檢，完成對(duì)工業(yè)裝備的保護(hù)性檢查，記錄排查信息并提供工業(yè)裝備的健康數(shù)據(jù)；e)應(yīng)支持獲取并管理工業(yè)裝備上存儲(chǔ)的日志信息，實(shí)現(xiàn)日志信息的審計(jì)維護(hù)功能。7工業(yè)互聯(lián)網(wǎng)平臺(tái)間接口要求7.1互通管理類接口互通管理類接口應(yīng)包括：6a)支持工業(yè)互聯(lián)網(wǎng)平臺(tái)配置，具備工業(yè)互聯(lián)網(wǎng)平臺(tái)間的互聯(lián)操作及配置平臺(tái)實(shí)例的能力；b)支持服務(wù)配置，具備對(duì)工業(yè)互聯(lián)網(wǎng)平臺(tái)開放服務(wù)實(shí)現(xiàn)配置調(diào)整的能力；c)具備工業(yè)互聯(lián)網(wǎng)平臺(tái)間的網(wǎng)絡(luò)診斷功能；d)具備工業(yè)互聯(lián)網(wǎng)平臺(tái)間開放服務(wù)的訪問功能；e)具備長連接資源的釋放操作，提供應(yīng)答確認(rèn)功能。7.2數(shù)據(jù)操作類接口數(shù)據(jù)操作類接口應(yīng)包括：a)支持通過符合相關(guān)規(guī)定的請(qǐng)求/響應(yīng)模式實(shí)現(xiàn)同步信息交換；b)支持通過消息隊(duì)列機(jī)制，完成發(fā)布/訂閱模式的異步信息交換；c)提供句法互操作功能，識(shí)別工業(yè)互聯(lián)網(wǎng)平臺(tái)間交換信息的數(shù)據(jù)組織格式；d)提供數(shù)據(jù)互操作功能，識(shí)別工業(yè)互聯(lián)網(wǎng)平臺(tái)間交換信息的數(shù)據(jù)模型。7.3安全輔助類接口安全輔助類接口應(yīng)具備：a)設(shè)備安全接入能力，設(shè)備接入到工業(yè)互聯(lián)網(wǎng)平臺(tái)時(shí)需進(jìn)行必要的授權(quán)登錄，結(jié)合數(shù)據(jù)加密傳輸實(shí)現(xiàn)設(shè)備加密通信，保證設(shè)備接入安全可靠；b)應(yīng)用安全接入能力，應(yīng)用接入到工業(yè)互聯(lián)網(wǎng)平臺(tái)時(shí)需進(jìn)行必要的授權(quán)與鑒別，保證應(yīng)用接入安全可靠；c)數(shù)據(jù)安全管理能力，基于平臺(tái)數(shù)據(jù)的安全等級(jí)對(duì)數(shù)據(jù)安全的生存周期進(jìn)行管理，保證數(shù)據(jù)安全可靠。7.4運(yùn)維管理類接口運(yùn)維管理類接口應(yīng)包括：a)支持記錄、存儲(chǔ)、查詢工業(yè)互聯(lián)網(wǎng)平臺(tái)間的服務(wù)配置和服務(wù)訪問日志；b)支持日志審計(jì)，異常診斷和處理模型數(shù)據(jù)。[1]GB/T114