ICS35.240.99CCSL6723IDB23/T3080—2022前言 12規(guī)范性引用文件 13術(shù)語和定義 14縮略語 25總體框架與基本要求 25.1總體框架 25.2二級節(jié)點(diǎn)技術(shù)要求 25.3二級節(jié)點(diǎn)接口要求 35.4企業(yè)節(jié)點(diǎn)標(biāo)識注冊要求 36標(biāo)識注冊 36.1基于Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識 36.2基于數(shù)據(jù)模板創(chuàng)建標(biāo)識 87標(biāo)識查詢 7.1必須帶前綴的查詢 7.2可以省略前綴的查詢 13附錄A（資料性）狀態(tài)碼 15參考文獻(xiàn) DB23/T3080—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由黑龍江省工業(yè)和信息化廳提出、歸口并組織實(shí)施。本文件由黑龍江省工業(yè)信息化發(fā)展中心（黑龍江省電子技術(shù)研究所）解釋。本文件起草單位：黑龍江省工業(yè)信息化發(fā)展中心（黑龍江省電子技術(shù)研究所）、黑龍江省標(biāo)準(zhǔn)化研究院、黑龍江然也科技有限公司、黑龍江省創(chuàng)新推廣工業(yè)互聯(lián)網(wǎng)發(fā)展中心有限公司。本文件主要起草人：鄭顯生、董力、朱穎濱、王淼庚、施曉林、劉澍、陳要武、郭宇亮、袁良武、車涵、李輝、張敬、周文華、姜欣、趙金曉、李寶才、張智、王軍、劉鵬林。本文件為首次發(fā)布。DB23/T3080—20221黑龍江工業(yè)互聯(lián)網(wǎng)標(biāo)識解析（綜合型）二級節(jié)點(diǎn)公共服務(wù)平臺數(shù)據(jù)接口規(guī)范本文件規(guī)定了黑龍江工業(yè)互聯(lián)網(wǎng)標(biāo)識解析（綜合型）二級節(jié)點(diǎn)公共服務(wù)平臺的總體框架與基本要求，以及標(biāo)識注冊、標(biāo)識查詢等數(shù)據(jù)接口要求。本文件適用于黑龍江省工業(yè)互聯(lián)網(wǎng)標(biāo)識解析（綜合型）二級節(jié)點(diǎn)與企業(yè)節(jié)點(diǎn)間的數(shù)據(jù)接口管理。2規(guī)范性引用文件本文件沒有規(guī)范性引用文件。3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1標(biāo)識編碼能夠唯一識別機(jī)器、產(chǎn)品等物理資源和算法、工序等虛擬資源的身份符號。3.2標(biāo)識注冊針對工業(yè)互聯(lián)網(wǎng)標(biāo)識編碼的規(guī)劃、申請與分配、使用情況反饋、生命周期管理、標(biāo)識有效性管理，標(biāo)識分配使用情況的信息收集以及標(biāo)識關(guān)聯(lián)信息的采集等功能。3.3標(biāo)識解析根據(jù)標(biāo)識編碼查詢目標(biāo)對象網(wǎng)絡(luò)位置或者相關(guān)信息。3.4國家頂級節(jié)點(diǎn)國家或地區(qū)內(nèi)部最頂級的標(biāo)識服務(wù)節(jié)點(diǎn)，能夠面向全國范圍提供頂級標(biāo)識解析服務(wù)，以及標(biāo)識備案、標(biāo)識認(rèn)證等管理能力。3.5標(biāo)識解析二級節(jié)點(diǎn)DB23/T3080—20222面向特定行業(yè)或者多個(gè)行業(yè)提供標(biāo)識服務(wù)的公共節(jié)點(diǎn)，以下簡稱為二級節(jié)點(diǎn)。3.6企業(yè)節(jié)點(diǎn)企業(yè)內(nèi)部的標(biāo)識服務(wù)節(jié)點(diǎn)，能夠面向特定企業(yè)提供標(biāo)識注冊、標(biāo)識解析服務(wù)、標(biāo)識數(shù)據(jù)服務(wù)等，既可以獨(dú)立部署，也可以作為企業(yè)信息系統(tǒng)的組成要素。4縮略語下列縮略語適用于本文件。API：應(yīng)用程序接口（ApplicationProgrammingInterface)HDFS：Hadoop分布式文件系統(tǒng)（HadoopDistributedFileSystem）HBASE：Hadoop數(shù)據(jù)庫（HadoopDatabase）RDBMS：關(guān)系式數(shù)據(jù)庫管理系統(tǒng)（RelationalDatabaseManagementSystem）5總體框架與基本要求5.1總體框架黑龍江省工業(yè)互聯(lián)網(wǎng)標(biāo)識解析（綜合型）二級節(jié)點(diǎn)公共服務(wù)平臺的總體框架示意圖，見圖1。圖1公共服務(wù)平臺接口框架示意圖5.2二級節(jié)點(diǎn)技術(shù)要求DB23/T3080—20223應(yīng)滿足下列條件：a)服務(wù)可用性應(yīng)達(dá)到99.99%以上；b)支持IPv4、IPv6雙協(xié)議棧的標(biāo)識注冊及解析服務(wù)；c)支持對企業(yè)節(jié)點(diǎn)及標(biāo)識查詢客戶端的雙向身份認(rèn)證；d)支持對標(biāo)識解析過程中數(shù)據(jù)傳輸?shù)臋C(jī)密性與完整性保護(hù)；e)支持對標(biāo)識信息的訪問權(quán)限控制能力；f)具備流量重定向等拒絕服務(wù)攻擊防護(hù)能力。5.3二級節(jié)點(diǎn)接口要求應(yīng)滿足下列條件：a)提供標(biāo)識注冊、標(biāo)識解析等相關(guān)接口；b)采用UTF-8字符編碼,Content-Type為application/json；c)除特殊指定外，接口請求方式為POST；d)提供基于Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識的接口和基于數(shù)據(jù)模板創(chuàng)建標(biāo)識的接口。5.4企業(yè)節(jié)點(diǎn)標(biāo)識注冊要求在中華人民共和國境內(nèi)依法登記注冊具有獨(dú)立法人資格的企業(yè)、事業(yè)單位、社會團(tuán)體。6標(biāo)識注冊6.1基于Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識6.1.1創(chuàng)建Handle數(shù)據(jù)類型6.1.1.1請求路徑：/api/loongxy-lxhl/lxhl/createHandleDataType。6.1.1.2請求方式：POST。6.1.1.3請求參數(shù)，見表1。表1基于Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識的請求參數(shù)為每家企業(yè)分配的APPID，接口6.1.1.4響應(yīng)參數(shù)，見表2。表2基于Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識的響應(yīng)參數(shù)DB23/T3080—202246.1.1.5測試用例，格式如下。{}6.1.2根據(jù)Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識6.1.2.1請求路徑：/api/loongxy-lxhl/lxhl/createHandleByType。6.1.2.2請求方式：POST。6.1.2.3請求參數(shù)，見表3。表3根據(jù)Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識8業(yè)互聯(lián)網(wǎng)前綴一致，則可以省略工業(yè)6.1.2.4響應(yīng)參數(shù)，見表4。表4根據(jù)Handle數(shù)據(jù)類型創(chuàng)建標(biāo)識的響應(yīng)參數(shù)6.1.2.5測試用例，格式如下。{DB23/T3080—20225{"handleDataType":"PRODUCT_NAME"{"handleDataType":"PRICE",{"handleDataType":"BATCHNO",{"handle":"88.210.36{}]}]}6.1.3根據(jù)Handle數(shù)據(jù)類型添加標(biāo)識項(xiàng)6.1.3.1請求路徑：/api/loongxy-lxhl/lxhl/addHandleItemByType。6.1.3.2請求方式：POST。6.1.3.3請求參數(shù)，見表5。表5根據(jù)Handle數(shù)據(jù)類型添加標(biāo)識項(xiàng)8DB23/T3080—20226表5根據(jù)Handle數(shù)據(jù)類型添加標(biāo)識項(xiàng)（續(xù)）引用的標(biāo)識碼，如果與handle字略工業(yè)互聯(lián)網(wǎng)前綴。如果引用的是其他企業(yè)的碼，則必須加上工業(yè)互6.1.3.4響應(yīng)參數(shù)，見表6。表6根據(jù)Handle數(shù)據(jù)類型添加標(biāo)識項(xiàng)的響應(yīng)參數(shù)6.1.3.5測試用例，格式如下。{"appId":"企業(yè)唯一appId","handle":{"handleDataType":"BATCHNO","value":"A031000}]}6.1.4根據(jù)Handle數(shù)據(jù)類型修改標(biāo)識值6.1.4.1請求路徑：/api/loongxy-lxhl/lxhl/updateHandleByType。6.1.4.2請求方式：POST。6.1.4.3請求參數(shù)，見表7。表7根據(jù)Handle數(shù)據(jù)類型修改標(biāo)識值DB23/T3080—20227表7根據(jù)Handle數(shù)據(jù)類型修改標(biāo)識值（續(xù)）85.1.1接口創(chuàng)建的Handle數(shù)據(jù)類型段工業(yè)互聯(lián)網(wǎng)前綴一致，則可以6.1.4.4響應(yīng)參數(shù)，見表8。表8根據(jù)Handle數(shù)據(jù)類型修改標(biāo)識值的響應(yīng)參數(shù)6.1.4.5測試用例，格式如下。{"appId":"企業(yè)唯一appId","handle":{"handleDataType":"PRODUCT_NAME"{"index":10001,"handleDataType":"PRICE",}]}DB23/T3080—202286.2基于數(shù)據(jù)模板創(chuàng)建標(biāo)識6.2.1創(chuàng)建或修改數(shù)據(jù)模板6.2.1.1請求路徑：/api/loongxy-lxhl/lxhl/saveTemplate。6.2.1.2請求方式：POST。6.2.1.3請求參數(shù)，見表9。表9創(chuàng)建或修改數(shù)據(jù)模板模板名稱。如果存在則修改6.2.1.4響應(yīng)參數(shù)，見表10。表10創(chuàng)建或修改數(shù)據(jù)模板的響應(yīng)參數(shù)6.2.1.5測試用例，格式如下。{"appId":"企業(yè)唯一appId",{DB23/T3080—20229{{}]}6.2.2根據(jù)模板創(chuàng)建標(biāo)識6.2.2.1請求路徑：/api/loongxy-lxhl/lxhl/createHandleByTemplate。6.2.2.2請求方式：POST。6.2.2.3請求參數(shù)，見表11。表11根據(jù)模板創(chuàng)建標(biāo)識86.2.2.4響應(yīng)參數(shù)，見表12。DB23/T3080—2022表12根據(jù)模板創(chuàng)建標(biāo)識的響應(yīng)參數(shù)6.2.2.5測試用例，格式如下。{{{{}]}6.2.3根據(jù)模板修改標(biāo)識6.2.3.1請求路徑：/api/loongxy-lxhl/lxhl/updateHandleByTemplate。6.2.3.2請求方式：POST。6.2.3.3請求參數(shù)，見表13。表13根據(jù)模板修改標(biāo)識表13根據(jù)模板修改標(biāo)識（續(xù)）8標(biāo)識屬性索引,索引值必須與注冊6.2.3.4響應(yīng)參數(shù)，見表14。表14根據(jù)模板修改標(biāo)識的響應(yīng)參數(shù)6.2.3.5測試用例，格式如下。{"appId":"企業(yè)唯－appId","{{{DB23/T3080—2022}]}7標(biāo)識查詢7.1必須帶前綴的查詢7.1.1請求路徑：/api/loongxy-lxhl/lxhl/queryHandle?handle=標(biāo)識碼。7.1.2請求方式：GET。7.1.3請求參數(shù)，見表15。表15必須帶前綴查詢的請求參數(shù)7.1.4響應(yīng)參數(shù)，見表16。表16必須帶前綴查詢的響應(yīng)參數(shù)7.1.5測試用例，格式如下。{{DB23/T3080—2022{{}]}7.2可以省略前綴的查詢7.2.1請求路徑：/api/loongxy-lxhl/lxhl/queryHandle。7.2.2請求方式：POST。7.2.3請求參數(shù)，見表17。表17可以省略前綴的查詢標(biāo)識碼?？梢约由瞎I(yè)互聯(lián)網(wǎng)前綴也可7.2.4響應(yīng)參數(shù)，見表18。表18可以省略前綴的查詢的響應(yīng)參數(shù)DB23/T3080—2022表18可以省略前綴的查詢的響應(yīng)參數(shù)（續(xù)）7.2.5測試用例，格式如下。