工業(yè)互聯(lián)網(wǎng)標識解析 儀器儀表 應(yīng)用服務(wù)平臺接口規(guī)范

1的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T15843.3—2023信息技術(shù)安全技術(shù)實體鑒別第3部分：采用數(shù)字簽名技術(shù)GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全等級保護基本要求GB/T35273—2020信息安全技術(shù)個人信息安全規(guī)范DB37/T3523.2—2019公共數(shù)據(jù)開放第2部分：數(shù)據(jù)脫敏指南4縮略語API:應(yīng)用程序編程接口(ApplicationProgrammingInterface)App:應(yīng)用程序(Application)2HTTP:超文本傳輸協(xié)議(HypertextTransferHTTPS:安全超文本傳輸協(xié)議(HypertextTransferPrMQTT:消息隊列遙測傳輸協(xié)議(MessageQueuingTelemetryTransport)a)安全性：提供多種安全可靠的技術(shù)手段b)開放性：采用通用的接口設(shè)計標準，保證與其他系統(tǒng)的互聯(lián)互通。c)靈活性：能根據(jù)業(yè)務(wù)變化，靈活調(diào)整接口監(jiān)控管理類監(jiān)控管理類中間件接入類儀器儀表運行類部署發(fā)布類交易結(jié)算類儀器儀表狀態(tài)類公共服務(wù)類服務(wù)訂閱類分析計算類標識管理類客戶關(guān)系類報警事件類公共信息類統(tǒng)計指標類測量信息類訂購信息類零部件信息類產(chǎn)品信息類客戶信息類標識發(fā)現(xiàn)類數(shù)據(jù)加解密類秘鑰管理類標識采集類權(quán)限管理類身份認證類標識類接口事件類接口標識管理類消息事件類標識查詢類3a)身份認證類：包含自然人認證(用戶名/密碼、手機短信、第三方認證)、接口API認證等接口。b)權(quán)限管理類：包含獲取權(quán)限、授予權(quán)限、刪除權(quán)限等接口。c)密鑰管理類：包含密鑰上傳、密鑰刪除等接口。d)數(shù)據(jù)加解密類：包含數(shù)據(jù)加密、數(shù)據(jù)解密等接口。6.3數(shù)據(jù)類接口數(shù)據(jù)類接口應(yīng)包含但不限于以下類型。a)客戶信息類：包含獲取客戶資料信息、獲取客戶認證信息、獲取APP認證信息、獲取合作伙伴信息、會員信息、反饋信息等接口。b)產(chǎn)品信息類：包含獲取儀器儀表基本信息、獲取儀器儀表詳細信息、儀器儀表分類信息、獲取儀器儀表評價信息等接口。c)零部件信息類：包含獲取產(chǎn)品零件信息、獲取產(chǎn)品部件信息、獲取產(chǎn)品原材料信息、獲取零部件分類信息等接口。d)訂購信息類：包含獲取商品信息、獲取商品訂單信息、獲取賬單信息、獲取合約信息、獲取結(jié)算分成信息、獲取積分信息等接口。e)測量信息類：包含獲取儀器儀表測點信息、獲取儀器儀表設(shè)備信息、獲取儀器儀表位置信息、獲取企業(yè)網(wǎng)關(guān)信息、獲取采集點信息等接口。f)統(tǒng)計指標類：包含獲取標識注冊量信息、獲取測量數(shù)據(jù)報送指標信息、獲取服務(wù)使用記錄統(tǒng)計信息等接口。g)公共信息類：包含獲取企業(yè)單位類型字典信息、獲取企業(yè)證件字典信息、獲取行政區(qū)劃編碼信息、國家統(tǒng)計局行政管轄區(qū)信息等接口。6.4服務(wù)類接口服務(wù)類接口應(yīng)包含但不限于以下類型。a)客戶關(guān)系類：包含自然人新增服務(wù)、企業(yè)信息注冊服務(wù)、企業(yè)信息變更服務(wù)、服務(wù)提供商注冊服務(wù)、服務(wù)提供商信息變更服務(wù)等接口。b)標識管理類：包含標識注冊服務(wù)、標識編碼服務(wù)、標識賦碼服務(wù)、標識溯源服務(wù)等接口。c)分析計算類：包含客戶分析評價服務(wù)、產(chǎn)品分析評價服務(wù)、儀器儀表測量類數(shù)據(jù)分析服務(wù)、儀器儀表全周期視圖等接口。d)服務(wù)訂閱類：包含服務(wù)發(fā)布、服務(wù)訂閱、服務(wù)授權(quán)、訂單服務(wù)等接口。e)公共服務(wù)類：包含資源上傳下載服務(wù)、儀器儀表分類更新服務(wù)、零部件分配服務(wù)、數(shù)據(jù)采集服務(wù)、數(shù)據(jù)存儲服務(wù)、數(shù)據(jù)處理服務(wù)等接口。f)交易結(jié)算類：包含商品交易或服務(wù)結(jié)算、票據(jù)信息等接口。6.5應(yīng)用類接口應(yīng)用類接口應(yīng)包含但不限于以下類型。a)部署發(fā)布類：包含應(yīng)用創(chuàng)建、應(yīng)用上傳、服務(wù)綁定、服務(wù)解綁、應(yīng)用啟動、應(yīng)用實例數(shù)設(shè)置、應(yīng)用動態(tài)伸縮設(shè)置、應(yīng)用停止、獲取域名詳情、綁定域名、解綁域名、應(yīng)用銷毀等接口。b)中間件接入類：包含服務(wù)接入、創(chuàng)建服務(wù)實例、服務(wù)實例配置、獲取環(huán)境變量、刪除服務(wù)實例、獲取服務(wù)實例狀態(tài)等接口。c)監(jiān)控管理類：包含查看應(yīng)用流量、查看應(yīng)用訪問量、查看應(yīng)用CPU、查看應(yīng)用內(nèi)存、4監(jiān)控報警設(shè)置等接口。6.6標識類接口標識類接口應(yīng)包含標識采集類接口、標識查詢類接口、標識發(fā)現(xiàn)類接口以及標識管理類接口，具體內(nèi)容如下。a)標識采集類：包含儀器儀表標識編碼的生成、標識數(shù)據(jù)的采集，以及向標識解析節(jié)點發(fā)起的注冊登記業(yè)務(wù)。b)標識查詢類：包含標識解析，給出儀器儀表產(chǎn)品在制造、銷售、檢驗、使用和計量、管理過程中產(chǎn)生的數(shù)據(jù)。c)標識發(fā)現(xiàn)類：根據(jù)指定條件查詢相關(guān)的工業(yè)互聯(lián)網(wǎng)標識解析信息服務(wù)的功能。d)標識管理類：包含標識的更新、刪除以及備份等接口。6.7事件類接口事件類接口應(yīng)包含消息事件類、報警事件類接口，具體內(nèi)容如下。a)消息事件類：包含編碼事件、生產(chǎn)事件、調(diào)試事件、流通事件、安裝事件、檢校事件、維修事件和報廢事件等接口。b)報警事件類：包含報警事件創(chuàng)建、報警事件設(shè)置、獲取報警事件、報警事件刪除、報警事件觸發(fā)等接口。6.8運行類接口運行類接口應(yīng)包含儀器儀表狀態(tài)類、儀器儀表運行類接口，具體內(nèi)容如下。a)儀器儀表狀態(tài)類：包含儀器儀表運行時間、獲取儀器儀表當前計量、檢校狀態(tài)等接b)儀器儀表運行類：包含儀器儀表運行數(shù)據(jù)采集等接口。7接口技術(shù)接口技術(shù)要求應(yīng)包括但不限于以下內(nèi)容。a)接口傳輸協(xié)議：支持HTTPS、MQTT和AMQP等協(xié)議中的一種或多種。b)接口請求方式：1)支持創(chuàng)建資源、獲取資源、更新資源、刪除資源4種操作方式；2)采用HTTPS協(xié)議時應(yīng)使用標準的HTTP請求方法。c)支持跨編程語言、跨操作系統(tǒng)調(diào)用。d)通過應(yīng)用服務(wù)平臺分配的接口密鑰、訪問令牌等方式對調(diào)用服務(wù)申請進行授權(quán)驗證。8接口開發(fā)接口開發(fā)要求應(yīng)包括但不限于以下內(nèi)容。a)接口描述：描述出接口的概要信息。b)URL格式：域名+/API+/版本號+/業(yè)務(wù)標識。c)輸入?yún)?shù)：給出參數(shù)名稱、數(shù)據(jù)類型、參數(shù)值、是否必填等輸入信息。d)返回參數(shù)：給出參數(shù)名稱、數(shù)據(jù)類型、是否必填、備注等輸出信息。9接口使用5泄露給第三方使用。工業(yè)互聯(lián)網(wǎng)標識解析儀器儀表應(yīng)用服務(wù)平臺接口調(diào)用具體流程見圖2,d)客戶進入平臺開發(fā)者中心查詢接口服務(wù)目錄，并下載應(yīng)用服務(wù)返回令牌(token)返回數(shù)據(jù)企業(yè)客戶平臺11.2.2編寫自動化測試腳本，分別測試四種HTTP請求方法(POST、GET、PUT、DELETE),611.3.1檢查API文檔或技術(shù)規(guī)格說明書，確認其中是否包含對接口功能的詳11.3.3查閱API文檔中的輸入?yún)?shù)部分，確認每個參數(shù)的名稱、數(shù)據(jù)類型、默認值(如果有)以及是否為必需