ICS 35.240.50 CCS L 70 YD 中华人民共和国通信行业标准 YD/TXXXXXXXXX [代替YD/T] 工业互联网标识解析 递归节点接口技术 要求 Identification and resolution system for the Industrial Internet - The interface technical requirements for the recursive node XXXX-XX-XX 发布 XXXX-XX-XX 实施 中华人民共和国工业和信息化部 发布 YD/T XXXXX—XXXX 目 次 前 II 1范围 2规范性引用文件 3术语和定义 4缩略语. 5工业互联网标识解析递归节点对接接口 6接口技术要求 6.1标识递归查询. 6.2业务统计同步， 6.3运行状态同步. 6.4安全状态同步. 6.5接口性能 附录A （资料性） 递归节点接口数据示例， A.1标识递归查询接口示例 A.2业务统计同步接口示例 11 A.3运行状态同步接口示例 12 A.4安全状态同步接口示例 YD/T XXXXX—XXXX 前 言 本文件按照GB/T1.1一2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中国通信标准化协会提出并归口。 本文件起草单位：中国联合网络通信集团有限公司、中国信息通信研究院、联通（江苏）产业互联 网有限公司、南京优速网络科技有限公司、北京邮电大学、网络通信与安全紫金山实验室、牙木科技股 份有限公司。 本文件主要起草人：张国鹏、曲扬、徐成杰、贾雪琴；池程、田娟、谢滨、朱斯语；蒋海涛、马松 松、吴承谕、李岚；王丽、张慧丽、吴兴利、汪勇；陈宇、刘国栋、唐诗琦；黄韬、谢人超；彭开来、 霍如；于凯、赵连军、徐慧龙。 II YD/T XXXXX—XXXX 工业互联网标识解析递归节点接口技术要求 1范围 本文件规定了工业互联网标识解析递归节点对接接口的技术要求。 本标准适用于工业互联网标识解析递归节点的建设、运营和使用。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 YD/TXXXX-XXXX工业互联网标识解析递归节点技术要求 3术语和定义 下列术语和定义适用于本文件。 3. 1 工业互联网标识解析国家顶级节点national-levelnodeofidentificationandresolutionforthe Industrial Internet 面向一个国家或地区提供顶级标识解析服务，以及标识备案、标识认证等管理服务的公共节点，简 称“国家顶级节点”。 3. 2 工业互联网标识解析递归节点recursivenodeofidentificationandresolutionfortheIndustrial Internet 面向客户端提供标识解析入口服务的公共节点，简称“递归节点”。 3. 3 工业互联网标识解析二级节点secondary-levelnodeofidentificationandresolutionfortheIndustrial Internet 面向特定行业或者多个行业提供标识服务的公共节点，简称“二级节点”。 3. 4 工业互联网标识解析企业节点enterprisenodeofidentificationandresolutionfortheIndustrial Internet 面向企业内部提供标识编码注册和标识解析服务的标识服务节点，并通过接入标识解析二级节点对 外提供解析服务，简称为“企业节点”。 YD/T XXXXX—XXXX 4 缩略语 下列缩略语适用于本文件。 CPU：中央处理器（CentralProcessingUnit） HTTP：超文本传输协议（HyperTextTransferProtocol） HTTPS：超文本传输安全协议（HyperTextTransferProtocolOverSecureSocketLayer） IPv4：互联网通信协议第四版（InternetProtocolVersion4） IPv6：互联网通信协议第六版（InternetProtocolVersion6） JSON：JS对象标记（JavaScriptObjectNotation） TCP：传输控制协议（TransmissionControlProtocol） UDP：用户数据报协议（UserDatagramProtocol) 5工业互联网标识解析递归节点对接接口 工业互联网标识解析递归节点应实现与国家顶级节点、二级节点、企业节点的互联互通，为客户端 提供标识递归查询。客户端可以是来自企业信息系统、工业互联网平台、工业互联网APP、中间件等多 种不同形式。同时，递归节点应与国家顶级节点对接进行业务统计数据、运行状态和安全状态的同步。 工业互联网标识解析递归节点对接接口示意图见图1，接口主要包括标识递归查询、业务统计同步、运 行状态同步、安全状态同步。 工业互联网标识解析国家顶级节点 工业互联网 标识通月 业务块计 云行达市 安全长态 标识解析 宣询 可步 级节点 标识进 查询 工业互联网标识解析递归节点 工业互联网 标识建 标识辉析 查动 标识冠归 企业节点 客户端 图1工业互联网标识解析递归节点对接接口示意图 6接口技术要求 6.1标识递归查询 标识递归查询接口至少支持DNS、Handle、Ecode、GS1、OID等常见标识体系协议中的一种。为了 满足标识递归查询需求，应支持基于应用层协议（HTTP、HTTPS）及基于传输层协议（UDP、TCP） 两种形式的数据传输。 2 xXxX—XxXxX1/0 注：标识递归查询流程应遵循YD/T200X-XXXX的相关规定 a）基于HTTP/HTTPS协议标识递归查询 接口协议：HTTP、HTTPS 数据格式：提交和返回数据均采用JSON格式 接口地址：请求的URL地址，由域名或IP、端口号、接口路径组成 请求参数：见表1，具体示例内容见附录A.1.1。 表1递归节点递归解析接口请求参数项 参数 必选 类型 说明 identity true String 标识编码 返回参数：！ 见表2-表3， 可能是下一级的IP地址信息或者是标识信息。 具体示例内容见附录A.1.1。 表2递归节点递归解析接口返回参数项（标识IP地址类） 字段号 返回字段 字段类型 说明 10 data. values [X]. index int 标识索引 data. values [X]. type 02 string 展示名 03 data. values [x]. data json 站点信息 04 data. values[x]. data. version unsigned int 站点版本号 05 unsigned int 协议版本号 data. values [x]. data.protocolVersion 06 data. values [x]. data. serialNumber unsigned int 站点信息更新记录号 07 data. values[x]. data. PrimaryMask unsigned 标识站点服务为主站点 char 80 data. values [x]. data. hashOption unsigned 服务站点使用的散列选项 char 60 data. values [x]. data. HashFilter string 保留字段 10 data, values[x].data. AttributeList 键值对数组 可选的键值对数组，描述站点说明 11 data. values [x]. data. servers[y]. serverid Unsigned int 站点服务ID 12 data. values[x]. data. servers[y]. address string 站点服务IP地址 13 data. values[x]. data. servers[Y]. interfaces 列表数组 [服务类型，接口承载协议，端口号] string 14 data, values[x]. tt] 缓存中过期时间 15 data. modelPic string 标识图片存储的相对路径 16 data. templateId string 如标识关联本平台注册模板，则返 回标识ID， 否则为空 17 data. handleIdentity string 标识前缀 18 data. enterprise. erpName string 企业名称 19 data, enterprise. erpTrade string 企业所属行业 20 data, enterprise. erpPhone string 联系方式 21 data. enterprise. erpUrl string 企业官网 22 data. enterprise. erpAddress string 企业所属地址 企业介绍 23 data. enterprise.erpDescription string 24 message string 附带消息 25 status int 返回结果状态。1：成功；0：失败。 3