DB37-T4811.2-2025工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析 儀器儀表 第2部分：應(yīng)用服務(wù)平臺(tái)接口規(guī)范

Q/LB.□XXXXX-XXXX工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析儀器儀表第2部分：應(yīng)用服務(wù)平臺(tái)接口規(guī)范范圍本文件規(guī)定了工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析儀器儀表應(yīng)用服務(wù)平臺(tái)接口設(shè)計(jì)、接口分類、接口技術(shù)、接口開發(fā)、接口使用和接口安全等方面的要求，描述了對(duì)應(yīng)的證實(shí)方法。本文件適用于工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析儀器儀表應(yīng)用服務(wù)平臺(tái)能力建設(shè)及應(yīng)用。規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T15843.3—2023信息技術(shù)安全技術(shù)實(shí)體鑒別第3部分：采用數(shù)字簽名技術(shù)的機(jī)制GB/T15851.3—2018信息技術(shù)安全技術(shù)帶消息恢復(fù)的數(shù)字簽名方案第3部分：基于離散對(duì)數(shù)的機(jī)制GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求GB/T35273—2020信息安全技術(shù)個(gè)人信息安全規(guī)范DB37/T3523.2—2019公共數(shù)據(jù)開放第2部分：數(shù)據(jù)脫敏指南術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。

令牌token通過應(yīng)用服務(wù)平臺(tái)登錄認(rèn)證后生成，用于標(biāo)識(shí)用戶的登錄身份信息。

客戶customer完成應(yīng)用服務(wù)平臺(tái)注冊(cè)并通過審核的自然人或法人主體。

身份認(rèn)證identityauthentication對(duì)自然人的身份進(jìn)行確認(rèn)。身份認(rèn)證包含登錄認(rèn)證和實(shí)名核驗(yàn)。縮略語(yǔ)下列縮略語(yǔ)適用于本文件。AMQP：高級(jí)消息隊(duì)列協(xié)議（AdvancedMessageQueuingProtocol）API：應(yīng)用程序編程接口（ApplicationProgrammingInterface）App：應(yīng)用程序（Application）AppKey：應(yīng)用密鑰（ApplicationKey）CPU：中央處理器（CentralProcessingUnit）HTTP：超文本傳輸協(xié)議（HypertextTransferProtocol）HTTPS：安全超文本傳輸協(xié)議（HypertextTransferProtocolSecure）MQTT：消息隊(duì)列遙測(cè)傳輸協(xié)議（MessageQueuingTelemetryTransport）SDK：軟件開發(fā)工具包（Software

Development

Kit）URL：統(tǒng)一資源定位符（UniformResourceLocator）接口設(shè)計(jì)接口設(shè)計(jì)應(yīng)包括但不限于以下內(nèi)容。安全性：提供多種安全可靠的技術(shù)手段，保證服務(wù)接口的安全。開放性：采用通用的接口設(shè)計(jì)標(biāo)準(zhǔn)，保證與其他系統(tǒng)的互聯(lián)互通。靈活性：能根據(jù)業(yè)務(wù)變化，靈活調(diào)整接口容量與性能。接口分類概述工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析儀器儀表應(yīng)用服務(wù)平臺(tái)應(yīng)對(duì)外提供安全類接口、數(shù)據(jù)類接口、服務(wù)類接口和應(yīng)用類接口以及標(biāo)識(shí)類接口、事件類接口和運(yùn)行類接口。應(yīng)用服務(wù)平臺(tái)接口分類見圖1。接口分類安全類接口安全類接口應(yīng)包含但不限于以下類型。身份認(rèn)證類：包含自然人認(rèn)證（用戶名/密碼、手機(jī)短信、第三方認(rèn)證）、接口API認(rèn)證等接口。權(quán)限管理類：包含獲取權(quán)限、授予權(quán)限、刪除權(quán)限等接口。密鑰管理類：包含密鑰上傳、密鑰刪除等接口。數(shù)據(jù)加解密類：包含數(shù)據(jù)加密、數(shù)據(jù)解密等接口。數(shù)據(jù)類接口數(shù)據(jù)類接口應(yīng)包含但不限于以下類型?？蛻粜畔㈩悾喊@取客戶資料信息、獲取客戶認(rèn)證信息、獲取APP認(rèn)證信息、獲取合作伙伴信息、會(huì)員信息、反饋信息等接口。產(chǎn)品信息類：包含獲取儀器儀表基本信息、獲取儀器儀表詳細(xì)信息、儀器儀表分類信息、獲取儀器儀表評(píng)價(jià)信息等接口。零部件信息類：包含獲取產(chǎn)品零件信息、獲取產(chǎn)品部件信息、獲取產(chǎn)品原材料信息、獲取零部件分類信息等接口。訂購(gòu)信息類：包含獲取商品信息、獲取商品訂單信息、獲取賬單信息、獲取合約信息、獲取結(jié)算分成信息、獲取積分信息等接口。測(cè)量信息類：包含獲取儀器儀表測(cè)點(diǎn)信息、獲取儀器儀表設(shè)備信息、獲取儀器儀表位置信息、獲取企業(yè)網(wǎng)關(guān)信息、獲取采集點(diǎn)信息等接口。統(tǒng)計(jì)指標(biāo)類：包含獲取標(biāo)識(shí)注冊(cè)量信息、獲取測(cè)量數(shù)據(jù)報(bào)送指標(biāo)信息、獲取服務(wù)使用記錄統(tǒng)計(jì)信息等接口。公共信息類：包含獲取企業(yè)單位類型字典信息、獲取企業(yè)證件字典信息、獲取行政區(qū)劃編碼信息、國(guó)家統(tǒng)計(jì)局行政管轄區(qū)信息等接口。服務(wù)類接口服務(wù)類接口應(yīng)包含但不限于以下類型?？蛻絷P(guān)系類：包含自然人新增服務(wù)、企業(yè)信息注冊(cè)服務(wù)、企業(yè)信息變更服務(wù)、服務(wù)提供商注冊(cè)服務(wù)、服務(wù)提供商信息變更服務(wù)等接口。標(biāo)識(shí)管理類：包含標(biāo)識(shí)注冊(cè)服務(wù)、標(biāo)識(shí)編碼服務(wù)、標(biāo)識(shí)賦碼服務(wù)、標(biāo)識(shí)溯源服務(wù)等接口。分析計(jì)算類：包含客戶分析評(píng)價(jià)服務(wù)、產(chǎn)品分析評(píng)價(jià)服務(wù)、儀器儀表測(cè)量類數(shù)據(jù)分析服務(wù)、儀器儀表全周期視圖等接口。服務(wù)訂閱類：包含服務(wù)發(fā)布、服務(wù)訂閱、服務(wù)授權(quán)、訂單服務(wù)等接口。公共服務(wù)類：包含資源上傳下載服務(wù)、儀器儀表分類更新服務(wù)、零部件分配服務(wù)、數(shù)據(jù)采集服務(wù)、數(shù)據(jù)存儲(chǔ)服務(wù)、數(shù)據(jù)處理服務(wù)等接口。交易結(jié)算類：包含商品交易或服務(wù)結(jié)算、票據(jù)信息等接口。應(yīng)用類接口應(yīng)用類接口應(yīng)包含但不限于以下類型。部署發(fā)布類：包含應(yīng)用創(chuàng)建、應(yīng)用上傳、服務(wù)綁定、服務(wù)解綁、應(yīng)用啟動(dòng)、應(yīng)用實(shí)例數(shù)設(shè)置、應(yīng)用動(dòng)態(tài)伸縮設(shè)置、應(yīng)用停止、獲取域名詳情、綁定域名、解綁域名、應(yīng)用銷毀等接口。中間件接入類：包含服務(wù)接入、創(chuàng)建服務(wù)實(shí)例、服務(wù)實(shí)例配置、獲取環(huán)境變量、刪除服務(wù)實(shí)例、獲取服務(wù)實(shí)例狀態(tài)等接口。監(jiān)控管理類：包含查看應(yīng)用流量、查看應(yīng)用訪問量、查看應(yīng)用CPU、查看應(yīng)用內(nèi)存、監(jiān)控報(bào)警設(shè)置等接口。標(biāo)識(shí)類接口標(biāo)識(shí)類接口應(yīng)包含標(biāo)識(shí)采集類接口、標(biāo)識(shí)查詢類接口、標(biāo)識(shí)發(fā)現(xiàn)類接口以及標(biāo)識(shí)管理類接口，具體內(nèi)容如下。標(biāo)識(shí)采集類：包含儀器儀表標(biāo)識(shí)編碼的生成、標(biāo)識(shí)數(shù)據(jù)的采集，以及向標(biāo)識(shí)解析節(jié)點(diǎn)發(fā)起的注冊(cè)登記業(yè)務(wù)。標(biāo)識(shí)查詢類：包含標(biāo)識(shí)解析，給出儀器儀表產(chǎn)品在制造、銷售、檢驗(yàn)、使用和計(jì)量、管理過程中產(chǎn)生的數(shù)據(jù)。標(biāo)識(shí)發(fā)現(xiàn)類：根據(jù)指定條件查詢相關(guān)的工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析信息服務(wù)的功能。標(biāo)識(shí)管理類：包含標(biāo)識(shí)的更新、刪除以及備份等接口。事件類接口事件類接口應(yīng)包含消息事件類、報(bào)警事件類接口，具體內(nèi)容如下。消息事件類：包含編碼事件、生產(chǎn)事件、調(diào)試事件、流通事件、安裝事件、檢校事件、維修事件和報(bào)廢事件等接口。報(bào)警事件類：包含報(bào)警事件創(chuàng)建、報(bào)警事件設(shè)置、獲取報(bào)警事件、報(bào)警事件刪除、報(bào)警事件觸發(fā)等接口。運(yùn)行類接口運(yùn)行類接口應(yīng)包含儀器儀表狀態(tài)類、儀器儀表運(yùn)行類接口，具體內(nèi)容如下。儀器儀表狀態(tài)類：包含儀器儀表運(yùn)行時(shí)間、獲取儀器儀表當(dāng)前計(jì)量、檢校狀態(tài)等接口。儀器儀表運(yùn)行類：包含儀器儀表運(yùn)行數(shù)據(jù)采集等接口。接口技術(shù)接口技術(shù)要求應(yīng)包括但不限于以下內(nèi)容。接口傳輸協(xié)議：支持HTTPS、MQTT和AMQP等協(xié)議中的一種或多種。接口請(qǐng)求方式：支持創(chuàng)建資源、獲取資源、更新資源、刪除資源4種操作方式；采用HTTPS協(xié)議時(shí)應(yīng)使用標(biāo)準(zhǔn)的HTTP請(qǐng)求方法。支持跨編程語(yǔ)言、跨操作系統(tǒng)調(diào)用。通過應(yīng)用服務(wù)平臺(tái)分配的接口密鑰、訪問令牌等方式對(duì)調(diào)用服務(wù)申請(qǐng)進(jìn)行授權(quán)驗(yàn)證。接口開發(fā)接口開發(fā)要求應(yīng)包括但不限于以下內(nèi)容。接口描述：描述出接口的概要信息。URL格式：域名＋/API＋/版本號(hào)＋/業(yè)務(wù)標(biāo)識(shí)。輸入?yún)?shù)：給出參數(shù)名稱、數(shù)據(jù)類型、參數(shù)值、是否必填等輸入信息。返回參數(shù)：給出參數(shù)名稱、數(shù)據(jù)類型、是否必填、備注等輸出信息。接口使用工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析儀器儀表應(yīng)用服務(wù)平臺(tái)使用時(shí)，應(yīng)按照接口調(diào)用流程進(jìn)行企業(yè)注冊(cè)，上傳相關(guān)材料，經(jīng)平臺(tái)運(yùn)營(yíng)方審核通過后，為使用方授權(quán)認(rèn)證信息，使用方獲取的信息不應(yīng)泄露給第三方使用。工業(yè)互聯(lián)網(wǎng)標(biāo)識(shí)解析儀器儀表應(yīng)用服務(wù)平臺(tái)接口調(diào)用具體流程見圖2，主要包括：用戶登錄應(yīng)用服務(wù)平臺(tái)進(jìn)行企業(yè)注冊(cè)，等待平臺(tái)運(yùn)營(yíng)方審核；審核通過后，客戶進(jìn)入平臺(tái)開發(fā)者中心選擇對(duì)應(yīng)接口服務(wù)目錄申請(qǐng)AppKey；應(yīng)用服務(wù)平臺(tái)為客戶分配對(duì)應(yīng)的AppKey及密鑰；客戶進(jìn)入平臺(tái)開發(fā)者中心查詢接口服務(wù)目錄，并下載接口簽名SDK包；客戶根據(jù)AppKey及密鑰調(diào)用平臺(tái)API認(rèn)證接口或使用SDK包，獲取訪問令牌；客戶根據(jù)訪問令牌及生成的簽名調(diào)用平臺(tái)接口，或使用SDK包訪問平臺(tái)接口。接口調(diào)用流程接口安全接口相關(guān)安全要求應(yīng)符合GB/T35273—2020、GB/T22239—2019、DB37/T3523.2—2019、GB/T15851.3—2018、GB/T15843.3—2023的相關(guān)規(guī)定。證實(shí)方法接口分類證實(shí)檢查平臺(tái)的技術(shù)文檔、API文檔或用戶手冊(cè)，確認(rèn)是否明確列出了這些接口及其功能描述。實(shí)際調(diào)用每個(gè)接口，驗(yàn)證它們的響應(yīng)是否符合預(yù)期。審查平臺(tái)的源代碼，查看是否有實(shí)現(xiàn)這些接口的相關(guān)代碼。接口技術(shù)證實(shí)檢查平臺(tái)的API文檔或技術(shù)規(guī)格說明書，確認(rèn)其支持的接口傳輸協(xié)議。實(shí)際測(cè)試調(diào)用這些接口，驗(yàn)證它們是否按預(yù)期工作。編寫自動(dòng)化測(cè)試腳本，分別測(cè)試四種HTTP請(qǐng)求方法（POST、GET、PUT、DELETE），確保每種請(qǐng)求均得到正確響應(yīng)。使用不同編程語(yǔ)言編寫客戶端代碼，嘗試調(diào)用平臺(tái)提供的接口；在不同操作系統(tǒng)上部署并運(yùn)行這些客戶端，接口調(diào)用成功且結(jié)果一致。獲取接口密鑰或訪問令牌，觀察接口響應(yīng)，確認(rèn)是否需要有效的授權(quán)信息才能訪問接口，并驗(yàn)證授權(quán)失敗時(shí)的返回結(jié)果是否符合預(yù)期。接口開發(fā)證實(shí)檢查API文檔或技術(shù)規(guī)格說明書，確認(rèn)其中是否包含對(duì)接口功能的詳細(xì)描述。檢查API文檔中的URL示例，確認(rèn)是否符合規(guī)定的格式。查閱API文檔中的輸入?yún)?shù)部分，確認(rèn)每個(gè)參數(shù)的名稱、數(shù)據(jù)類型、默認(rèn)值（如果有）以及是否為必需參數(shù)。審查API文檔中的返回參數(shù)部分，確認(rèn)每個(gè)返回參數(shù)的名稱、數(shù)據(jù)類型、是否為必需以及任何相關(guān)的備注信息。調(diào)用接口并分析返回的數(shù)據(jù)，驗(yàn)證返回參數(shù)是否符合文檔描述。接口使用證實(shí)檢查平臺(tái)的API文檔或用戶手冊(cè)，確認(rèn)其中是否詳細(xì)描述了企業(yè)注冊(cè)的接口調(diào)用流程、是否存在用于上傳材料的接口。與平臺(tái)運(yùn)營(yíng)方溝通或查閱相關(guān)文檔，了解審核流程的具體步驟和標(biāo)準(zhǔn)。觀察或記錄一個(gè)真實(shí)的審核過程，確認(rèn)其是否符合既定的流程和標(biāo)準(zhǔn)。在審核通過后，檢查平臺(tái)是否自動(dòng)生成了認(rèn)證信息（如API密鑰、訪問令牌等），并將其提供給使用方。驗(yàn)