DB23/T 3080-2022 黑龙江工业互联网标识解析(综合型)二级节点公共服务平台数据接口规范

DB23/T 3080-2022 Heilongjiang Industrial Internet Identifier Deciphering (Integrated Type) Secondary Node Public Service Platform Data Interface Specification

黑龙江省地方标准 简体中文 现行 页数:19页 | 格式:PDF

基本信息

标准号
DB23/T 3080-2022
标准类型
黑龙江省地方标准
标准状态
现行
中国标准分类号(CCS)
国际标准分类号(ICS)
发布日期
2022-01-29
实施日期
2022-02-28
发布单位/组织
黑龙江省市场监督管理局
归口单位
-
适用范围
-

研制信息

起草单位:
起草人:
出版信息:
页数: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数据类型创建标识的响应参数

参数类型

定制服务

    推荐标准

    相似标准推荐

    更多>