DB23/T 3080-2022 黑龙江工业互联网标识解析(综合型)二级节点公共服务平台数据接口规范
DB23/T 3080-2022 Heilongjiang Industrial Internet Identifier Deciphering (Integrated Type) Secondary Node Public Service Platform Data Interface Specification
基本信息
发布历史
-
2022年01月
研制信息
- 起草单位:
- 起草人:
- 出版信息:
- 页数:19页 | 字数:- | 开本: -
内容描述
ICS35.240.99
CCSL67
23
黑龙江省地方标准
DB23/T3080—2022
黑龙江工业互联网标识解析(综合型)
二级节点公共服务平台数据接口规范
2022-01-29发布2022-03-01实施
黑龙江省市场监督管理局发布
DB23/T3080—2022
目 次
前言.....................................................................................................................................................................II
1范围.................................................................................................................................................................1
2规范性引用文件.............................................................................................................................................1
3术语和定义.....................................................................................................................................................1
4缩略语.............................................................................................................................................................2
5总体框架与基本要求.....................................................................................................................................2
5.1总体框架.................................................................................................................................................2
5.2二级节点技术要求.................................................................................................................................2
5.3二级节点接口要求.................................................................................................................................3
5.4企业节点标识注册要求.........................................................................................................................3
6标识注册.........................................................................................................................................................3
6.1基于Handle数据类型创建标识...........................................................................................................3
6.2基于数据模板创建标识.........................................................................................................................8
7标识查询.......................................................................................................................................................12
7.1必须带前缀的查询...............................................................................................................................12
7.2可以省略前缀的查询...........................................................................................................................13
附录A(资料性)状态码..........................................................................................................................15
参考文献.............................................................................................................................................................16
I
DB23/T3080—2022
前 言
本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起
草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由黑龙江省工业和信息化厅提出、归口并组织实施。
本文件由黑龙江省工业信息化发展中心(黑龙江省电子技术研究所)解释。
本文件起草单位:黑龙江省工业信息化发展中心(黑龙江省电子技术研究所)、黑龙江省标准化研
究院、黑龙江然也科技有限公司、黑龙江省创新推广工业互联网发展中心有限公司。
本文件主要起草人:郑显生、董力、朱颖滨、王淼庚、施晓林、刘澍、陈要武、郭宇亮、袁良武、
车涵、李辉、张敬、周文华、姜欣、赵金晓、李宝才、张智、王军、刘鹏林。
本文件为首次发布。
II
DB23/T3080—2022
黑龙江工业互联网标识解析(综合型)二级节点公共服务平台数据
接口规范
1范围
本文件规定了黑龙江工业互联网标识解析(综合型)二级节点公共服务平台的总体框架与基本要求,
以及标识注册、标识查询等数据接口要求。
本文件适用于黑龙江省工业互联网标识解析(综合型)二级节点与企业节点间的数据接口管理。
2规范性引用文件
本文件没有规范性引用文件。
3术语和定义
下列术语和定义适用于本文件。
3.1
标识编码
能够唯一识别机器、产品等物理资源和算法、工序等虚拟资源的身份符号。
3.2
标识注册
针对工业互联网标识编码的规划、申请与分配、使用情况反馈、生命周期管理、标识有效性管理,
标识分配使用情况的信息收集以及标识关联信息的采集等功能。
3.3
标识解析
根据标识编码查询目标对象网络位置或者相关信息。
3.4
国家顶级节点
国家或地区内部最顶级的标识服务节点,能够面向全国范围提供顶级标识解析服务,以及标识备案、
标识认证等管理能力。
3.5
标识解析二级节点
1
DB23/T3080—2022
面向特定行业或者多个行业提供标识服务的公共节点,以下简称为二级节点。
3.6
企业节点
企业内部的标识服务节点,能够面向特定企业提供标识注册、标识解析服务、标识数据服务等,既
可以独立部署,也可以作为企业信息系统的组成要素。
4缩略语
下列缩略语适用于本文件。
API:应用程序接口(ApplicationProgrammingInterface)
HDFS:Hadoop分布式文件系统(HadoopDistributedFileSystem)
HBASE:Hadoop数据库(HadoopDatabase)
RDBMS:关系式数据库管理系统(RelationalDatabaseManagementSystem)
5总体框架与基本要求
5.1总体框架
黑龙江省工业互联网标识解析(综合型)二级节点公共服务平台的总体框架示意图,见图1。
图1公共服务平台接口框架示意图
5.2二级节点技术要求
2
DB23/T3080—2022
应满足下列条件:
a)服务可用性应达到99.99%以上;
b)支持IPv4、IPv6双协议栈的标识注册及解析服务;
c)支持对企业节点及标识查询客户端的双向身份认证;
d)支持对标识解析过程中数据传输的机密性与完整性保护;
e)支持对标识信息的访问权限控制能力;
f)具备流量重定向等拒绝服务攻击防护能力。
5.3二级节点接口要求
应满足下列条件:
a)提供标识注册、标识解析等相关接口;
b)采用UTF-8字符编码,Content-Type为application/json;
c)除特殊指定外,接口请求方式为POST;
d)提供基于Handle数据类型创建标识的接口和基于数据模板创建标识的接口。
5.4企业节点标识注册要求
在中华人民共和国境内依法登记注册具有独立法人资格的企业、事业单位、社会团体。
6标识注册
6.1基于Handle数据类型创建标识
6.1.1创建Handle数据类型
请求路径:/api/loongxy-lxhl/lxhl/createHandleDataType。
请求方式:POST。
请求参数,见表1。
表1基于Handle数据类型创建标识的请求参数
参数类型参数名字段长度参数说明备注
为每家企业分配的APPID,接口
StringappId30必填
调试前需要向相应人员索取。
Handle数据类型,即标识注册时
StringhandleDataType50必填
相应字段的名称。
响应参数,见表2。
表2基于Handle数据类型创建标识的响应参数
参数类型参数名备注
Integercode状态码(详见附录1)
Stringmsg提示信息
Objectobj返回的对象
3
DB23/T3080—2022
测试用例,格式如下。
示例:
{
"appId":"企业唯一appId",
"handleDataType":"SIZE"
}
6.1.2根据Handle数据类型创建标识
请求路径:/api/loongxy-lxhl/lxhl/createHandleByType。
请求方式:POST。
请求参数,见表3。
表3根据Handle数据类型创建标识
参数类型参数名字段长度参数说明备注
StringappId30必填
Stringhandle标识码。可以加上工业互联
200必填
网前缀也可以不加前缀。
Arrayitems标识属性列表必填
Intitems[i].index标识属性索引,不填则默认
8非必填
从10000开始。
Stringitems[i].handleDataType505.1.1接口创建的Handle数据类型必填
Stringitems[i].value2000标识属性内容值非必填
Arrayitems[i].references标识引用列表非必填
引用的标识码,如果与handle字段工
业互联网前缀一致,则可以省略工业
Stringitems[i].references[j].handle200非必填
互联网前缀。如果引用的是其他企业的
码,则必须加上工业互联网前缀。
响应参数,见表4。
表4根据Handle数据类型创建标识的响应参数
参数类型
定制服务
推荐标准
- QJ 2498.2-1993 模件组合式控制台结构及尺寸系列 框 1993-03-30
- GA/T 194-1998 中毒案件检材包装、贮存、运送及送检规则 1998-12-08
- YB/T 5300-2006 沥青焦真比重的测定方法 2006-07-27
- HB 5717-1982 拧入式直角管接头 1982-06-21
- HB 5761-1983 D型四通管接头 1984-08-23
- LY/T 1033-1991 人造板胶设备钢制焊接容器参数 1991-07-07
- HB 4-24-1983 拧入式三通管接头 1984-08-23
- JB/T 9592.1-1999 全金属12角法兰面锁紧螺母 型式和尺寸 1999-08-06
- HG/T 20703.9-2000 材料专业参加现场检验的要点 2000-11-22
- QJ 1383.4-1988 厢式车辆通用件 门铰链 1988-02-21