DB23_T 3080-2022 黑龙江工业互联网标识解析（综合型）二级节点公共服务平台数据接口规范.docx

《DB23_T 3080-2022 黑龙江工业互联网标识解析（综合型）二级节点公共服务平台数据接口规范.docx》由会员分享，可在线阅读，更多相关《DB23_T 3080-2022 黑龙江工业互联网标识解析（综合型）二级节点公共服务平台数据接口规范.docx（19页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS35.240.99CCSL6723黑龙江省地方标准DB23/T30802022黑龙江工业互联网标识解析（综合型）二级节点公共服务平台数据接口规范2022-01-29发布2022-03-01实施黑龙江省市场监督管理局发布DB23/T30802022目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.25总体框架与基本要求.25.1总体框架.25.2二级节点技术要求.25.3二级节点接口要求.35.4企业节点标识注册要求.36标识注册.36.1基于Handle数据类型创建标识.36.2基于数据模板创建标识.87标识查询.127.1必须带前缀的查询.127.2可以省略前缀的查

2、询.13附录A（资料性）状态码.15参考文献.16IDB23/T30802022前言本文件按照GB/T1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由黑龙江省工业和信息化厅提出、归口并组织实施。本文件由黑龙江省工业信息化发展中心（黑龙江省电子技术研究所）解释。本文件起草单位：黑龙江省工业信息化发展中心（黑龙江省电子技术研究所）、黑龙江省标准化研究院、黑龙江然也科技有限公司、黑龙江省创新推广工业互联网发展中心有限公司。本文件主要起草人：郑显生、董力、朱颖滨、王淼庚、施晓林、刘澍、陈要武、

3、郭宇亮、袁良武、车涵、李辉、张敬、周文华、姜欣、赵金晓、李宝才、张智、王军、刘鹏林。本文件为首次发布。IIDB23/T30802022黑龙江工业互联网标识解析（综合型）二级节点公共服务平台数据接口规范1范围本文件规定了黑龙江工业互联网标识解析（综合型）二级节点公共服务平台的总体框架与基本要求，以及标识注册、标识查询等数据接口要求。本文件适用于黑龙江省工业互联网标识解析（综合型）二级节点与企业节点间的数据接口管理。2规范性引用文件本文件没有规范性引用文件。3术语和定义下列术语和定义适用于本文件。3.1标识编码能够唯一识别机器、产品等物理资源和算法、工序等虚拟资源的身份符号。3.2标识注册针对工业

4、互联网标识编码的规划、申请与分配、使用情况反馈、生命周期管理、标识有效性管理，标识分配使用情况的信息收集以及标识关联信息的采集等功能。3.3标识解析根据标识编码查询目标对象网络位置或者相关信息。3.4国家顶级节点国家或地区内部最顶级的标识服务节点，能够面向全国范围提供顶级标识解析服务，以及标识备案、标识认证等管理能力。3.5标识解析二级节点1DB23/T30802022面向特定行业或者多个行业提供标识服务的公共节点，以下简称为二级节点。3.6企业节点企业内部的标识服务节点，能够面向特定企业提供标识注册、标识解析服务、标识数据服务等，既可以独立部署，也可以作为企业信息系统的组成要素。4缩略语下列

5、缩略语适用于本文件。API：应用程序接口（ApplicationProgrammingInterface)HDFS：Hadoop分布式文件系统（HadoopDistributedFileSystem）HBASE：Hadoop数据库（HadoopDatabase）RDBMS：关系式数据库管理系统（RelationalDatabaseManagementSystem）5总体框架与基本要求5.1总体框架黑龙江省工业互联网标识解析（综合型）二级节点公共服务平台的总体框架示意图，见图1。图1公共服务平台接口框架示意图5.2二级节点技术要求2参数类型参数名字段长度参数说明备注StringappId30为每

6、家企业分配的APPID，接口调试前需要向相应人员索取。必填StringhandleDataType50Handle数据类型，即标识注册时相应字段的名称。必填参数类型参数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象DB23/T30802022应满足下列条件：a)服务可用性应达到99.99%以上；b)支持IPv4、IPv6双协议栈的标识注册及解析服务；c)支持对企业节点及标识查询客户端的双向身份认证；d)支持对标识解析过程中数据传输的机密性与完整性保护；e)支持对标识信息的访问权限控制能力；f)具备流量重定向等拒绝服务攻击防护能力。5.3二

7、级节点接口要求应满足下列条件：a)提供标识注册、标识解析等相关接口；b)采用UTF-8字符编码,Content-Type为application/json；c)除特殊指定外，接口请求方式为POST；d)提供基于Handle数据类型创建标识的接口和基于数据模板创建标识的接口。5.4企业节点标识注册要求在中华人民共和国境内依法登记注册具有独立法人资格的企业、事业单位、社会团体。6标识注册6.1基于Handle数据类型创建标识6.1.1创建Handle数据类型6.1.1.1请求路径：/api/loongxy-lxhl/lxhl/createHandleDataType。6.1.1.2请求方式：POS

8、T。6.1.1.3请求参数，见表1。表1基于Handle数据类型创建标识的请求参数6.1.1.4响应参数，见表2。表2基于Handle数据类型创建标识的响应参数3参数类型参数名字段长度参数说明备注StringappId30必填Stringhandle200标识码。可以加上工业互联网前缀也可以不加前缀。必填Arrayitems标识属性列表必填Intitemsi.index8标识属性索引，不填则默认从10000开始。非必填Stringitemsi.handleDataType505.1.1接口创建的Handle数据类型必填Stringitemsi.value2000标识属性内容值非必填Arrayi

9、temsi.references标识引用列表非必填Stringitemsi.referencesj.handle200引用的标识码，如果与handle字段工业互联网前缀一致，则可以省略工业互联网前缀。如果引用的是其他企业的码，则必须加上工业互联网前缀。非必填参数类型参数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象DB23/T308020226.1.1.5测试用例，格式如下。示例：appId:企业唯一appId,handleDataType:SIZE6.1.2根据Handle数据类型创建标识6.1.2.1请求路径：/api/loongxy

10、-lxhl/lxhl/createHandleByType。6.1.2.2请求方式：POST。6.1.2.3请求参数，见表3。表3根据Handle数据类型创建标识6.1.2.4响应参数，见表4。表4根据Handle数据类型创建标识的响应参数6.1.2.5测试用例，格式如下。示例：appId:企业唯一appId,handle:2000091,items:4参数类型参数名字段长度参数说明备注StringappId30必填Stringhandle200标识码。可以加上工业互联网前缀也可以不加前缀。必填Arrayitems标识属性列表必填Intitemsi.index8标识属性索引，不填则默认从100

11、00开始非必填Stringitemsi.handleDataType505.1.1接口创建的Handle数据类型必填Stringitemsi.value2000标识属性内容值非必填Arrayitemsi.references标识引用列表非必填DB23/T30802022handleDataType:PRODUCT_NAME,value:菠萝,handleDataType:PRICE,value:8.5,handleDataType:BATCHNO,references:handle:88.210.366669/2000079,handle:20000906.1.3根据Handle数据类型添加标

12、识项6.1.3.1请求路径：/api/loongxy-lxhl/lxhl/addHandleItemByType。6.1.3.2请求方式：POST。6.1.3.3请求参数，见表5。表5根据Handle数据类型添加标识项5参数类型参数名字段长度参数说明备注Stringitemsi.referencesj.handle200引用的标识码，如果与handle字段工业互联网前缀一致，则可以省略工业互联网前缀。如果引用的是其他企业的码，则必须加上工业互联网前缀。非必填参数类型参数名字段长度参数说明备注StringappId30必填Stringhandle200标识码。可以加上工业互联网前缀也可以不加前缀

13、。必填Arrayitems标识属性列表必填DB23/T30802022表5根据Handle数据类型添加标识项（续）6.1.3.4响应参数，见表6。表6根据Handle数据类型添加标识项的响应参数参数类型参数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象6.1.3.5测试用例，格式如下。示例：appId:企业唯一appId,handle:2000094,items:handleDataType:BATCHNO,value:A03100016.1.4根据Handle数据类型修改标识值6.1.4.1请求路径：/api/loongxy-lxhl/

14、lxhl/updateHandleByType。6.1.4.2请求方式：POST。6.1.4.3请求参数，见表7。表7根据Handle数据类型修改标识值6参数类型参数名字段长度参数说明备注Intitemsi.index8标识属性索引，必须与注册时标识属性索引一致必填Stringitemsi.handleDataType505.1.1接口创建的Handle数据类型必填Stringitemsi.value2000标识属性内容值非必填Arrayitemsi.references标识引用列表非必填Stringitemsi.referencesj.handle200引用的标识码，如果与handle字段工

15、业互联网前缀一致，则可以省略工业互联网前缀。如果引用的是其他企业的码，则必须加上工业互联网前缀。非必填参数类型参数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象DB23/T30802022表7根据Handle数据类型修改标识值（续）6.1.4.4响应参数，见表8。表8根据Handle数据类型修改标识值的响应参数6.1.4.5测试用例，格式如下。示例：appId:企业唯一appId,handle:2000094,items:index:10000,handleDataType:PRODUCT_NAME,value:西瓜,index:1000

16、1,handleDataType:PRICE,value:5.07参数类型参数名字段长度参数说明备注StringappId30必填StringtemplateName50模板名称。如果存在则修改模板，否则新增模板。必填Stringdescription500模板描述非必填Arrayitems模板项列表必填Stringitemsi.nameCn50字段中文名必填Stringitemsi.nameEn50字段英文名必填Booleanitemsi.required10是否必填必填Intitemsi.minLength10字段最小长度必填Intitemsi.maxLength10字段最大长度必填参数类

17、型参数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象DB23/T308020226.2基于数据模板创建标识6.2.1创建或修改数据模板6.2.1.1请求路径：/api/loongxy-lxhl/lxhl/saveTemplate。6.2.1.2请求方式：POST。6.2.1.3请求参数，见表9。表9创建或修改数据模板6.2.1.4响应参数，见表10。表10创建或修改数据模板的响应参数6.2.1.5测试用例，格式如下。示例：appId:企业唯一appId,templateName:neil-0310,description:Neil测试模板

18、,items:nameCn:名称,nameEn:name,required:true,minLength:2,maxLength:208参数类型参数名字段长度参数说明备注StringappId30必填Stringhandle200标识码。可以加上工业互联网前缀也可以不加前缀。必填StringtemplateName50模板名称必填Arrayitems标识属性列表必填intitemsi.index8标识属性索引（不能为1001）必填Stringitemsi.name50标识属性类型,对应数据模板的nameEn。必填Stringitemsi.value2000标识属性内容值必填DB23/T3080

19、2022,nameCn:颜色,nameEn:color,required:true,minLength:1,maxLength:10,nameCn:价格,nameEn:price,required:false,minLength:1,maxLength:106.2.2根据模板创建标识6.2.2.1请求路径：/api/loongxy-lxhl/lxhl/createHandleByTemplate。6.2.2.2请求方式：POST。6.2.2.3请求参数，见表11。表11根据模板创建标识6.2.2.4响应参数，见表12。9参数类型参数名字段长度参数说明备注StringappId30必填Strin

20、ghandle200标识码。可以加上工业互联网前缀也可以不加前缀。必填参数类型参数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象DB23/T30802022表12根据模板创建标识的响应参数6.2.2.5测试用例，格式如下。示例：appId:企业唯一appId,templateName:neil-0310,handle:2000097,items:index:2000,name:name,value:APPLE,index:2001,name:color,value:红色,index:2002,name:price,value:59996.

21、2.3根据模板修改标识6.2.3.1请求路径：/api/loongxy-lxhl/lxhl/updateHandleByTemplate。6.2.3.2请求方式：POST。6.2.3.3请求参数，见表13。表13根据模板修改标识10参数类型参数名字段长度参数说明备注StringtemplateName50模板名称必填Arrayitems标识属性列表必填intitemsi.index8标识属性索引,索引值必须与注册时对应属性的索引值一致。必填Stringitemsi.name50标识属性类型,对应数据模板的nameEn。必填Stringitemsi.value2000标识属性内容值必填参数类型参

22、数名备注Integercode状态码(详见附录1)Stringmsg提示信息Objectobj返回的对象DB23/T30802022表13根据模板修改标识（续）6.2.3.4响应参数，见表14。表14根据模板修改标识的响应参数6.2.3.5测试用例，格式如下。示例：appId:企业唯appId,templateName:neil-0310,handle:2000097,items:index:2000,name:name,value:猕猴桃,index:2001,name:color,value:yellow,11参数类型参数名参数说明备注IntresponseCode响应码Stringhan

23、dle查询的标识Stringmsg提示信息Arrayitems标识属性列表Intitemsi.index标识属性索引Stringitemsi.name标识属性类型Stringitemsi.value标识属性内容值Stringitemsi.timestamp时间戳参数类型参数名字段长度参数说明备注String标识码200必须加上工业互联网前缀必填DB23/T30802022index:2002,name:price,value:8.97标识查询7.1必须带前缀的查询7.1.1请求路径：/api/loongxy-lxhl/lxhl/queryHandle?handle=标识码。7.1.2请求方式：

24、GET。7.1.3请求参数，见表15。表15必须带前缀查询的请求参数7.1.4响应参数，见表16。表16必须带前缀查询的响应参数7.1.5测试用例，格式如下。示例：responseCode:1,handle:88.210.366669/2000097,msg:,items:index:2000,12参数类型参数名参数说明备注IntresponseCode响应码Stringhandle查询的标识Stringmsg提示信息Arrayitems标识属性列表Intitemsi.index标识属性索引Stringitemsi.name标识属性类型参数类型参数名字段长度参数说明备注Stringappid3

25、0必填Stringhandle200标识码。可以加上工业互联网前缀也可以不加前缀。必填DB23/T30802022name:name,value:猕猴桃,timestamp:2021-03-1012:08:06,index:2001,name:color,value:yellow,timestamp:2021-03-1012:08:06,index:2002,name:price,value:8.9,timestamp:2021-03-1012:08:067.2可以省略前缀的查询7.2.1请求路径：/api/loongxy-lxhl/lxhl/queryHandle。7.2.2请求方式：POS

26、T。7.2.3请求参数，见表17。表17可以省略前缀的查询7.2.4响应参数，见表18。表18可以省略前缀的查询的响应参数13参数类型参数名参数说明备注Stringitemsi.value标识属性内容值Stringitemsi.timestamp时间戳DB23/T30802022表18可以省略前缀的查询的响应参数（续）7.2.5测试用例，格式如下。示例：appId:企业唯一appId,handle:2000097或appId:企业唯一appId,handle:88.210.366669/200009714状态码提示信息1成功-1操作失败1001APPID不能为空1002APPID不正确1003

27、企业尚未通过公共服务平台分配1004企业尚未通过国家顶级节点审核1005标识码不能为空1006没有操作该前缀的权限1007标识项不能为空1008模板名称不能为空1009模板项不能为空1010用户不存在1011获取Token失败1012模板名称已存在1013模板名称不能为空1014模板不存在DB23/T30802022AA附录A（资料性）状态码A.1状态码对应的提示信息，见表A.1。表A.1状态码说明15DB23/T30802022参考文献1GB/T39443-2020公共信用信息交换方式及接口规范2GB/T40094.3-2021电子商务数据交易第3部分：数据接口规范3YD/T3844-2021工业互联网平台应用管理接口要求_16