《面向MES的工业互联网标识数据采集与互通系统中间件接口规范》（征求意见稿）

ICS35

CCSL67

T/EGAG

团体标准

T/EGAGXXX—2021

面向MES的工业互联网标识数据采集

与互通系统中间件接口规范

MiddlewareinterfacespecificationforMESorientedindustrial

Internetidentificationdataacquisitionandinterworkingsystem

（征求意见稿）

XXXX-XX-XX发布XXXX-XX-XX实施

广东省电子政务协会发布

T/EGAGXXX—2021

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

本文件由广东鑫兴科技有限公司提出。

本文件由广东省电子政务协会归口。

本文件起草单位：广东鑫兴科技有限公司、佛山维尚家具制造有限公司、广东腾一科技有限公司、

广东省智能家电研究院。

本文件主要起草人：区景安、胡杰、羊城、汪毅、梁欣毅、何新义、洪德兴……

本文件为首次发布。

III

T/EGAGXXX—2021

引言

无论是生产制造企业还是MES提供商，当出现异主、异构、异地的信息数据在跨域、跨平台的环境

下实现内部或外部信息系统与MES系统数据共享、互联互通的需求，难免一对一地专门对接开发，大大

提高了复杂度，增大了成本，不利于两化融合的推进和产业的升级。

以工业互联网标识作为基础，利用标识技术的共享互通特性实现的面向MES工业互联网标识数据采

集与互通系统中间件作为所有对接信息化系统接入对象，可有效消除各个信息系统与MES系统对接的差

异，降低接入难度，促进企业迅速发展。因此，有必要在业务技术层面统一该中间件接口规范，特制定

本规范。

本文件的发布机构提请注意，声明符合本文件时，可能涉及到[5.3安全服务类接口]、[5.4数据结

构化接口]、[5.5数据互通类接口]相关的专利的使用。

本文件的发布机构对于该专利的真实性、有效性和范围无任何立场。

该专利持有人已向本文件的发布机构承诺，他愿意同任何申请人在合理且无歧视的条款和条件下，

就专利授权许可进行谈判。该专利持有人的声明已在本文件的发布机构备案。相关信息可以通过以下联

系方式获得：

专利持有人姓名：广东鑫兴科技有限公司。

地址：广东省佛山市南海区金科路6号中控大厦9楼905-908室。

请注意除上述专利外，本文件的某些内容仍可能涉及专利。本文件的发布机构不承担识别专利的责

任。

IV

T/EGAGXXX—2021

面向MES的工业互联网标识数据采集与互通系统中间件接口规范

1范围

本文件规定了其他信息系统与中间件进行通讯时所使用的接口，包括报文的通讯结构、格式以及调

用指令说明等要求。

本文件适用于任何信息系统与任何接入该中间件的MES系统之间进行的数据采集、交换、共享和互

联互通的场景。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

下列术语和定义适用于本文件。

3.1

Handle

由TCP/IP的联合发明人、有“互联网之父”之称的RoberKahn博士发明，核心系统由美国国家创新

研究所（CNRI）开发。Handle在全球设立若干的根节点，根节点之间平等互通；可提供部分用户自定义

的编码能力，用户可以根据实际需求在编码体系的部分字段自定义编码规则。

3.2

工业互联网标识industrialinternetidentification

能够唯一识别机器、产品等物理资源和算法、工序等虚拟资源的身份符号，类似于“身份证”。

3.3

标识解析信息identityparsinginformation

根据标识编码查询目标对象网络位置或者相关信息的系统装置，对机器和物品进行唯一性的定位并

查询获取描述该对象的标识关联信息。

3.4

标识关联信息identifyassociatedinformation

标识关联信息是组成标识解析信息的单元，是标识解析后所获得的描述标识对象的具体信息，一般

采用Key-Value的形式存储，有多种关联信息的类型，如图片、网址、文本等，标识解析信息可以由多

条标识关联信息组成。

3.5

中间件middleware

1

T/EGAGXXX—2021

本文中间件是介于应用系统和MES系统之间的一类接口软件，它使用工业互联网标识所提供的基础

服务功能，衔接企业内部或外部其他应用系统的各个部分或不同的应用，能够达到资源共享、功能共享

的目的。

3.6

令牌pass

代表执行某些操作的权限的对象，接口的调用需要认证令牌，类似“通行证”。

3.7

密钥secretkey

密钥是一种参数，它是在明文转换为密文或将密文转换为明文的算法中输入的参数。

3.8

公钥publickey

公钥是密钥对的对外公开的非秘密一半，对应另一半的是私密保存的私钥，使用这个密钥对的时候,

如果用其中一个密钥加密一段数据，必须用另一个密钥解密。

4符号和缩略语

下列缩略语适用于本文件。

MES：制造企业生产过程执行管理系统（ManufacturingExecutionSystem）

SM4:国密分组密码算法（对称算法，用于加密）

SM9:国密标识密码算法（非对称算法，用于签名）

URL:统一资源定位器（UniformResourceLocator）

DM:标识数据模板（DataModel），一般为多条标识关联信息的集合

RelateInfo:标识关联信息对象

5具体接口规范

5.1概述

该接口规范无限定任何开发语言，任一开发语言皆可按照本规范要求的接口命名、接口功能以及传

入传出参数类型设计。下述接口规范是按照JAVA开发语言习惯编写，其他开发语言可参照相同或类似的

数据类型进行替换映射。

5.2基础服务类接口

5.2.1初始化中间件

表1

名称init()

描述初始化中间件，初始化token并缓存标识数据模板。

返回值void

参数名称类型说明

2

T/EGAGXXX—2021

5.2.2释放中间件

表2

名称release()

描述释放中间件，清除缓存的标识数据模板与token。

返回值void

名称类型说明

参数

5.2.3更新数据模板

表3

名称refreshDataModel()

调用该中间件接口，会将用户在标识自助平台中配置的标识数据模板下载并缓存到本地内存

描述

中。

返回值void

名称类型说明

参数

5.2.4更新权限令牌

表4

名称refreshToken()

调用该接口，中间件将会重新向标识平台申请一个新的权限令牌（token）,并缓存到本地内

描述

存中（token有效期为10分钟）。

返回值void

名称类型说明

参数

5.3安全服务类接口

5.3.1生成业务密钥

表5

名称createBusSecretKey()

调用该接口，中间件将会创建一个业务密钥（对称密钥SM4）。该业务密钥将会用于对标识

描述

内容进行对称加密（SM4）。

返回值String

参数名称类型说明

3

T/EGAGXXX—2021

5.3.2获取中间件公钥

表6

名称queryPublicKey(Stringhandle)

调用该接口，中间件将会根据标识码获取与该标识码对应的中间件的加密公钥与签名公钥。

描述

获取公钥后，可以使用加密公钥对业务密钥进行加密（SM9）。

返回值String

名称类型说明

参数

handleString标识应用中间件的标识码

5.3.3加密业务密钥

表7

名称encryptBusSecretKey(Stringkey,StringpublicKey)

描述调用该接口，中间件将会对业务密钥进行数字加密（SM9），并返回出加密后的密文。

返回值String

名称类型说明

参数keyString业务密钥

publicKeyString加密公钥(由queryPublicKey获取)

5.3.4解密业务密钥

表8

名称decodeBusSecretKey(Stringciphertext)

描述调用该接口，中间件将会对业务密钥进行数字解密（SM9），并返回出业务密钥原文。

返回值String

名称类型说明

cipherttextString业务密钥

参数

encryptPriKeyString接收中间件的加密私钥

publicKeyObject接收中间件的加密公钥

5.3.5查询业务密钥

表9

名称queryBusSecretKey(StringhandleCode,booleandecrypt,Stringsender)

描述调用该接口，返回目标标识的对称加密业务密钥。

返回值String

参数名称类型说明

4

T/EGAGXXX—2021

handleCodeString目标标识的标识号

decryptboolean是否对查出的业务密钥进行解密

需要进行解密的中间件标识号,默认为当前中间

senderString

件。

5.3.6标识数据分享

表10

名称shareHandle(StringhandleCode,List<MvPublicKey>targetPublicKeys)

描述分享标识数据。

返回值void

名称类型说明

参数handleCodeString需要分享的标识码

targetPublicKeysList<MvPublicKey>需要分享的中间件公钥集合

5.4数据结构化接口

5.4.1生成标识关联信息数据（根据数据模板）

表11

名称genRelateInfoByDM(StringdmCode)

描述调用该接口，中间件将会根据标识数据模板生成标准的标识关联数据对象。

返回值List<RelateInfo>

名称类型说明

参数

dmCodeString数据模板编号

5.4.2生成一条标识关联信息（TEXT类型）

表12

genRelateInfoText(intindex,Stringlabel,Stringvalue,Stringdisplay,boolean

名称

cipher)

描述调用该接口，中间件将会生成一个标准的TEXT类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

valueString内容值

displayString显示值

cipherboolean是否加密

5

T/EGAGXXX—2021

5.4.3生成一条标识关联信息（LINK类型）

表13

名称genRelateInfoLink(intindex,Stringlabel,Stringtitle,Stringurl,booleancipher)

描述生成一个标准的LINK(超链接)类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

titleString超链接内容

urlString超链接URL

cipherboolean是否加密

5.4.4生成一条标识关联信息（Textarea类型）

表14

名称genRelateInfoTextarea(intindex,Stringlabel,Stringvalue,booleancipher)

描述生成一个标准的TEXTAREA(长文本)类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

valueString长文本内容

cipherboolean是否加密

5.4.5生成一条标识关联信息（HTML类型）

表15

名称genRelateInfoHtml(intindex,Stringlabel,Stringvalue,booleancipher)

描述调用该接口，中间件将会生成一个标准的HTML类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

valueStringHtml内容

cipherboolean是否加密

5.4.6生成一条标识关联信息（IMAGE类型）

6

T/EGAGXXX—2021

表16

名称genRelateInfoImage(intindex,Stringlabel,byte[]image,booleancipher)

调用该接口，中间件将会生成一个标准的IMAGE类型的标识关联数据对象（图片大小在300KB

描述

以内）。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

imagebyte[]图片(字节数组)

cipherboolean是否加密

5.4.7生成一条标识关联信息（IMAGE_BIG类型）

表17

名称genRelateInfoImageBig(intindex,Stringlabel,StringimageUrl,booleancipher)

调用该接口，中间件将会生成一个标准的IMAGE_BIG类型的标识关联数据对象（图片大小超

描述

过300KB，传入图片URL地址）。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

imageUrlString图片URL地址

cipherboolean是否加密

5.4.8生成一条标识关联信息（VIDEO类型）

表18

名称genRelateInfoVideo(intindex,Stringlabel,StringvideoUrl,booleancipher)

调用该接口，中间件将会生成一个标准的VIDEO类型的标识关联数据对象。（传入视频URL

描述

地址）

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

videoUrlString视频URL地址

cipherboolean是否加密(默认不加密)

5.4.9生成一条标识关联信息（URL类型）

7

T/EGAGXXX—2021

表19

名称genRelateInfoUrl(intindex,Stringurl,booleancipher)

描述调用该接口，中间件将会生成一个标准的URL类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

urlStringURL地址

cipherboolean是否加密（默认false）

5.4.10生成一条标识关联信息（PARENT类型）

表20

名称genRelateInfoParent(intindex,Stringlabel,Stringhandle)

描述调用该接口，中间件将会生成一个标准的PARENT类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

handleString标识码

5.4.11生成一条标识关联信息（CHILD类型）

表21

名称genRelateInfoChild(intindex,Stringlabel,Stringhandle)

描述调用该接口，中间件将会生成一个标准的C类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

labelString标题

handleString标识码

5.4.12生成一条标识关联信息（DATA_STRING类型）

表22

名称genRelateInfoDataString(intindex,Stringkey,Stringvalue,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_STRING类型的标识关联数据对象。

返回值RelateInfo

参数名称类型说明

8

T/EGAGXXX—2021

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

valueString数据value值

cipherboolean是否加密（默认false）

5.4.13生成一条标识关联信息（DATA_NUMBER类型）

表23

名称genRelateInfoDataNumber(intindex,Stringkey,intvalue,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_NUMBER类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复）

keyString数据key值

valueint数据value值

cipherboolean是否加密

5.4.14生成一条标识关联信息（DATA_DATETIME类型）

表24

名称genRelateInfoDataDatetime(intindex,Stringkey,Datevalue,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_DATETIME类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

valueDate数据value值

cipherboolean是否加密（默认false）

5.4.15生成一条标识关联信息（DATA_JSONOBJECT类型）

表25

名称genRelateInfoDataJsonObject(intindex,Stringkey,StringjsonStr,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_JSONOBJECT类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

9

T/EGAGXXX—2021

jsonStrStringJson字符串

cipherboolean是否加密（默认false）

5.4.16生成一条标识关联信息（DATA_JSONARRAY类型）

表26

名称genRelateInfoDataJsonArray(intindex,Stringkey,StringjsonStr,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_JSONARRAY类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

jsonArrStrStringJson数组字符串

cipherboolean是否加密

5.4.17生成一条标识关联信息（DATA_BASE64类型）

表27

名称genRelateInfoDataBase64(intindex,Stringkey,Stringbase64Str,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_BASE64类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

Base64StrStringBase64字符串

cipherboolean是否加密

5.4.18生成一条标识关联信息（DATA_INT类型）

表28

名称genRelateInfoDataInt(intindex,Stringkey,Stringvalue,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_INT类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

valueint整型数字

cipherboolean是否加密

10

T/EGAGXXX—2021

5.4.19生成一条标识关联信息（DATA_DOUBLE类型）

表29

名称genRelateInfoDataDouble(intindex,Stringkey,doublevalue,booleancipher)

描述调用该接口，中间件将会生成一个标准的DATA_DOUBLE类型的标识关联数据对象。

返回值RelateInfo

名称类型说明

参数

indexint标识关联信息索引号（不能重复，大于0）

keyString数据key值

valuedouble浮点型数字

cipherboolean是否加密

5.5数据互通类接口

表30

名称executeApi(StringapiHandle,StringparamJson)

描述调用该接口，将会调用用户发布到标识服务平台上的API服务接口

返回值JsonObject

名称类型说明

参数apiHandleString用户API标识码

paramJsonString用户API接口的参数(Json)

5.6标识应用接口

5.6.1生成标识码

表31

名称createHandleCode(BusTypetype)

描述调用该接口，中间件将会生成一个标识码。

返回值String

名称类型说明

参数

typeBusType业务类型

5.6.2创建标识

表32

createHandle(StringhandleCode,List<RelateInfo>infos,CipherModecipher,String

名称

busSecretKey)

描述调用该接口，中间件将会创建一个标识。

11

T/EGAGXXX—2021

返回值void

名称类型说明

参数

handleCodeString标识码

infosList<RelateInfo>标识关联信息

cipherCipherMode加密模式

busSecretKeyString业务密钥(解密后的sm4密钥)

5.6.3解析标识

表33

名称queryHandle(StringhandleCode,StringbusSecretKey)

描述调用该接口，中间件将会解析一个标识码，并返回标识关联信息。

返回值List<RelateInfo>

名称类型说明

参数

handleCodeString标识码

busSecretKeyString业务密钥(解密后的sm4密钥)

5.6.4注销标识

表34

名称removeHandle(StringhandleCode)

描述调用该接口，中间件将会注销一个标识码。

返回值void

名称类型说明

参数

handleCodeString标识码

5.6.5添加标识关联信息

表35

名称addRelateInfo(StringhandleCode,RelateInfoinfo,StringbusSecretKey)

描述调用该接口，中间件将会添加一条标识关联信息。

返回值void

名称类型说明

参数

handleCodeString标识码

infoRelateInfo标识关联信息

业务密钥(解密后的sm4密钥)，若关联信息指明

busSecretKeyString

了加密，此参数不能为空。

12

T/EGAGXXX—2021

5.6.6修改标识关联信息

表36

名称modifyRelateInfo(StringhandleCode,RelateInfoinfo,StringbusSecretKey)

描述调用该接口，中间件将会修改一条标识关联信息。

返回值void

名称类型说明

参数

handleCodeString标识码

infoRelateInfo标识关联信息

业务密钥(解密后的sm4密钥)，若关联信息指明

busSecretKeyString

了加密，此参数不能为空。

5.6.7删除标识关联信息

表37

名称removeRelateInfo(StringhandleCode,int[]indexs)

描述调用该接口，中间件将会删除多条标识关联信息。

返回值void

名称类型说明

参数

handleCodeString标识码

indexsint[]要删除的关联信息索引号（必须有值）

表38

名称removeRelateInfo(StringhandleCode,intindex)

描述调用该接口，中间件将会删除一条标识关联信息。

返回值void

名称类型说明

参数

handleString标识码

indexint要删除的关联信息索引号（必须有值）

5.6.8批量创建标识

表39

名称batchCreateHandle(List<BatchHandleVo>batchHandleList)

描述调用该接口，中间件将会一次性创建多个标识

名称类型说明

返回值

String业务单号

参数名称类型说明

13

T/EGAGXXX—2021

batchHandleListList标识信息

5.6.1查询批量创建标识进度

表40

名称queryBatchCreateProcess(StringbusId)

描述调用该接口，中间件将会查出批量创建单的标识创建结果

名称类型说明

[{

“handle”:“标识号码”,

返回值“finishTime”:“完成时间(毫秒)”,

String

“status”:(1:完成,0:未完成),

“result”:(1:成功,0:失败)

}]

参数名称类型说明

busIdString批量创建标识返回的业务单号

5.7错误码定义

5.7.1接口错误码

#00200000

1)错误码含义：标识API服务未知异常。

2)建议解决方法：请与系统管理员联系。

#00200001

1)错误码含义：接口必填参数为空或没有传入。

2)建议解决方法：请正确传入接口参数。

#00200002

1)错误码含义：解析输入参数出错。

2)建议解决方法：请检查数据输入格式。

#00200003

1)错误码含义：输入参数的code值与数据模板中的code不一致。

2)建议解决方法：请确保输入数据与数据模板数据相一致。

#00200004

1)错误码含义：数据存在相同的索引号(index)。

2)建议解决方法：数据索引号(index)不能重复。

#00200005

1)错误码含义：上传文件过大。

14

T/EGAGXXX—2021

2)建议解决方法：请调整文件大小。

#00200006

1)错误码含义：文件解base64编码错误。

2)建议解决方法：文件必须经过base64编码。

#00200007

1)错误码含义：标识查询错误。

2)建议解决方法：请检查标识号是否存在。

#00200008

1)错误码含义：添加标识属性发生错误。

2)建议解决方法：请检查输入数据是否正确。

#00200009

1)错误码含义：解析JSON数据时出错。

2)建议解决方法：请检查输入数据是否正确。

#00200010

1)错误码含义：输入参数缺少code值。

2)建议解决方法：请检查输入数据是否正确。

#00200011

1)错误码含义：IMAGE图片过大。

2)建议解决方法：IMAGE图片不能大于300KB。

#00200012

1)错误码含义：index值为null。

2)建议解决方法：index值不能为null，且index值不能重复。

#00200013

1)错误码含义：code值为null。

2)建议解决方法：code值不能为null，且code值不能重复。

#00200014

1)错误码含义：code值重复。

2)建议解决方法：code值不能为null，且code值不能重复。

#00200015

1)错误码含义：数据模板转换IMAGE出错。

2)建议解决方法：请与系统管理员联系。

#00200016

1)错误码含义：index值不能为空。

15

T/EGAGXXX—2021

2)建议解决方法：请输入index值。

#00200017

1)错误码含义：index值为null。

2)建议解决方法：index值不能