《复杂施工环境大型地下工程装备设计制造运维信息接口要求》

ICSXX.XX.XX

JXX

团体标准

T/BIAIMXXXXX-20XX

复杂施工环境大型地下工程装备设计制造运

维信息接口要求

SpecificationforDesign,Manufacturing,OperationandMaintenance

InformationInterfaceofLargeEquipmentinCompIicatedEnvironment

（征求意见稿）

20XX-XX-XX发布20XX-XX-XX实施

北京智能制造创新联盟发布

T/BIAIMXXXXX-20XX

目次

前言.....................................................................................II

1范围.......................................................................................I

2规范性引用文件............................................................................1

3术语与定义................................................................................1

4缩略语....................................................................................1

5接口协议..................................................................................1

6接口内容................................................................

6.1数据接口定义方式...................................................................I

6.1.1数据接口分类..................................................................1

6.1.2接口格式描述.................................................................1

6.2接口数据类型.......................................................................3

6.3设计接口...........................................................................4

6.3.1设计需求....................................................................4

6.3.2设计方案..................................................

6.3.3设计变更....................................................................4

6.4制造接口...........................................................................6

6.4.1生产计划....................................................................6

6.4.2排产排程结果................................................................6

6.4.3生产计划执行................................................................6

6.4.4异常信息....................................................................6

6.4.5采购计划....................................................................7

6.4.6采购计划执行..............................................

6.5运维接口..................................................................8

6.5.1运维需求.....................................................................8

6.5.2运维备件.....................................................................8

6.5.3运维人员.....................................................................8

6.5.4异常工况.....................................................................8

7接口安全..................................................................................9

7.1结构安全............................................................................9

7.2访问控制............................................................................9

7.3安全审计...........................................................................10

7.4边界完整性检查....................................................................10

7.5入侵防范...........................................................................10

T/BIAIMXXXXX-20XX

2/

刖百

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

起草。

请注意本文件的某此内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。

本文件由北京智能制造创新联盟提出.

本文件由北京智能制造创新联盟归口。

本文件起草单位：中国铁建重工集团股份有限公司、北京机械工业自动化研究所有限公司、无锡雪

浪数制科技有限公司等。

本文件主要起草人：xxxo

T/BIAIMXXXXX-20XX

复杂施工环境大型地下工程装备设计制造运维信息接口要求

1范围

本文件规定了复杂施工环境下大型地下工程装备设计制造运维环节一体化建设运用过程中，

各环节过程接口协议、内容以及安全的规范。

本文件适用于复杂施工环境下大型地下工程装备一体化集成方案设计与实施。

2规范性引用文件

下列文件中的条款通过本文件的引用而成为本文件的条款。下列文件对于本文件的应用是必

不可少的。凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适

用于本文件，然而，鼓励根据本文件达成协议的各方研究是否可使用这些文件的最新版本。凡是

不注日期的引用文件，其最新版本适用于本文件。

3术语与定义

T/BIAIMXXXX-2024界定的以及下列术语与定义适用于本文件。

4缩略语

JSON：JS对象简谱(JavaScriptObjectNotation)

REST：表达性状态转移(RepresentationalStateTransfer)

5接口要求

5.1接口基本要求

复杂施工环境大型地下工程装备设计制造运维一体化平台信息接口应满足以下基本要求：

a)网络要求：确保集成系统间网络通畅、稳定、安全；

b)数据安全要求：确保系统集成过程中具备完善的权限验证机制；

c)通信协议要求：满足Rost协议；

d)通信频率要求：＜lHz；

e)更新频率：25M的数据采用增量方式对接，或系统资源利用不高时间段进行更新。

5.2接口定义方式

5.2.1接口分类

复杂环境大型工程装备设计制造运维一体化平台提供的信息接口类型包括但不限于：

a)文件接口：基于超文本传输协议(HTTP)或超文本传输安全协议(HTTPS)网络协议的网络服

务，以电子文件形式传输数据；

b)API接口：基于HTTP或HTTPS网络协议的网络服务，用于平台与数据提供主体间通过调用API

接口获取数据。

5.2.2接口格式描述

接口说明包括但不限于：

T/BIAIMXXXXX-20XX

a）接口功能说明

主要包括：

——从众多的系统中提取数据到通用数据仓库，供报告、分析或商业情报之用

一一将现有系统的数据转化或合并为新系统和应用的格式和结构

——用软件即服务（SaaS）应用集成留在公司内的数据

b）接口地址格式

格式：协议:〃+域名或者地址+路径+参数

目前数据集成协议以Rset协议接口为主,所以地址中“协议”用“https”；

——地址中“域名或者地址”一般常见的是IP地址或者IP地址+端口号的方式，如涉及到外

网数据集成访问会采用外网域名的方式，目前兆丰机电采用IP地址+端口号的方式；

——这里地址的路径指接口对接时数据发布的地址路径；

——这里接口地址中的“参数”是用于请求数据时的“暗号”，需要集成方与被集成方进行

约定，或被访问方进行标准化规定。

示例：

https:〃〈域名或地tLz>/api/hufu-web/rcstData/lxtcst?apiTokcn=cell6f

https://<域名或地力二〉/iuapmdm/exr/mdmrs/newcenter/queryl.istMdByMdmCodes

c）请求参数

数据接口请求参数报文应包含，如下内容：

表1接口请求参数报文格式

参数名必填描述备注

mdmtokenY远程系统的令牌

useridY用户IDj051hqr3

数据接口请求参数F文应包含.如下内容:

表2接口请求参数正文格式

参数名类型是否数组必填备注

syslcmCodcstringNY远程系统编码

gdCodestringNY项目定义编码

codesjsonYY主数据编码（数组格式）

d）响应数据

返回类型参数应包含，如下内容:

表3接口响应参数格式

参数名是否数组必填描述

successNY接口访问状态

messageNY接口访问状态描述

2

T/BIAIMXXXXX-20XX

dataYY返回的主数据（JSON）

示例：

请求示例

(

"systemCode":"default",

"gdCodc":"pcrson",

"codes":[

"mdmCodcl",

"mdmCode2",

'•mdmCode3",

注：请求参数正文

返回示例

（

“data”:[{

“id”:“xxx（数据在此集成系统的主键值）;

,'code":',xxx",

,,name',:"xxx",

"pk_mdm":"xxx（数据的主数据唯一主键）",

"mdm_code":Hxxx（数据在模型中的唯一编码）",

"mdm_version":"l（数据版本。整型）",

"mdm_duplicate":"O（数据重复性，0为无重复。整型）”，

"creator":"admin（数据创建人）二

"createtime":"2022-0I-2313:17:26”,

,,modifier":"lihua（数据修改人）",

,,modifytime":"2022-01-2313:17:26",

"mdm_datastatus":"3（数据状态,0:未捉交，上审批中，2:驳回，3:已发布（三解封），

4:封存,5:已提交。整型）”，

"mdm_cleanstatus":"WAITING（数据清洗状态，WAITING:等待中；RUNNING:清洗中;

ERROR:清洗出错；COMPLETE:清洗结束；TRANSFER:已转化。）”

）1

"success":truc,

"message":"XXX杳询异常……（只有杳询失败时响应报文中才公出现此标签）"

）

5.3接口数据类型

复杂环境大型工程装备设计制造运维信息接口应覆盖以下数据类型，包括：

——字符串型；

一一整字型；

3

T/BIAIMXXXXX-20XX

•对象型。

6接口定义

6.1需求协同接口

6.1.1爬虫数据提交接口

爬虫数据提交接口定义见表4：

表4爬虫数据提交接口定义

接I」名称爬虫数据提交接口

接口说明提交工程相关爬虫数据

接口方法POST

至少包括:系统ID(systemCode)、项目ID(gdCode)需求ID、爬取到的

参数说明

项目信息(工程名称、工程行业、地理位置等)

返回值返回应用是否正常运行的状态信息

6.1.2需求列表查询接口

需求列表查询接口定义见表5：

表5需求列表查询接口定义

接口名称需求列表查询接口

接口说明根据账号ID获取项目需求信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)、需求ID

返回应用是否正常运行的状态信息和项目需求相关信息，如需求号、项目

返回值工号、工程名称、工程行业、地理位置、地下工程形式、设备类型、提交

时间、优化建议等。

6.2设计协同接口

6.2.1设计列表查询接口

设计列表查询接口定义见表6：

表6项目详细需求查询接口定义

接口名称项H详细需求查询接口

接口说明根据账号ID获取设计需求信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目【1)(gdCode)

返回应用是否正常运行的状态信息和设计列表信息，如项目工号、产品名

返回值

称、产品型号、最新需求提报时间、最新方案更新时间等。

6.2.2项目详细需求查询接口

项目详细需求查询接口定义见表7：

表7项目详细需求查询接口定义

接口名称项目详细需求查询接口

接口说明根据需求ID获取项目详细需求信息

4

T/BIAIMXXXXX-20XX

接口方法GET

参数说明至少包括:系统ID(systemCode)、项目ID(gdCodc)

返回应用是否正常运行的状态信息和项目需求相关信息，如需求号、项目

返回值工号、工程名称、工程行业、地理位置、隧道形式、设备类型、提交时间、

优化建议等。

6.2.3项目详细需求确认提交接口

项目详细需求确认提交接口定义见表8：

表8项目详细需求确认提交接口定义

接1」名称项目详细需求确认提交接口

接口说明确认提交项目详细需求信息

接口方法POST

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)、设计需求

返回值返回应用是否正常运行的状态信息

6.2.4项目设计结果查询接口

项目设计结果查询接口定义见表9：

表9项目设计结果查询接口定义

接口名称项目设计结果查询接口

接口说明根据项目ID提交设计方案信息进行设计结果确认

接口方法POST

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)＞需求设i•方案

返回值应用是否正常运行的状态信息

6.2.5项目设计结果确认提交接口

项目设计结果确认提交接II定义见表10：

表10项目设计结果确认提交接口定义

接口名称项H设计结果确认提交接口

接口说明根据项目ID获取项目设计结果信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目设计结果相关信息，如模块化配

返回值

置结果、定制化设计结果、三维预览页面链接等。

6.2.6项目设计变更查询接口

项目设计变更查询接口定义见表11：

表11项目设计变更查询接口定义

接口名称项目设计变更查询接口

接口说明根据项目ID获取项目设计变更信息

接口方法GET

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目设计变更相关信息，如装备设计

返回值

变更记录等。

5

T/BIAIMXXXXX-20XX

6.2.7设计制造协同接口

设计制造协同接口定义见表12：

表12设计制造协同接口定义

接口名称设计制造协同接口

接口说明根据一级BOM清单获取项目工艺信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)、一级BOM清单

返回应用是否正常运行的状态信息和项目制造工艺相关信息，如详细BOM、

返回值

设计图纸和工艺文件等。

6.3制造协同接口

6.3.1生产计划列表查询接口

生产计划列表查询接口定义见表13：

表13生产计划列表查询接口定义

接口名称生产计划列表查询接口

接口说明根据账号ID获取项目生产计划信息

接口方法GET

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目生产计划相关信息，如项目图纸、

返回值

物料生产计划列表(含自制件生产进度信息)等。

6.3.2待排批次查询接口

待排批次查询接口定义见表14：

表14待排批次查询接口定义

接口名称待排批次查询接口

接口说明根据选中的模型ID获取待排批次信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)＞待排模型ID

返回值返回应用是否正常运行的状态信息和模型待排批次相关信息。

6.3.3待排批次确认提交接口

待排批次确认提交接II定义见表15：

表15待排批次确认提交接口定义

接口名称待排批次确认提交接口

接口说明确认提交待排批次信息

接口方法POST

至少包括：系统ID(systemCode)、项目ID(gdCode)＞待排模型ID、带排

参数说明

批次信息

返回值返回应用是否正常运行的状态信息

6.3.4排程结果查询接口

排程结果食询接口定义见表16：

6

T/BIAIMXXXXX-20XX

表16排程结果查询接口定义

接口名称排程结果查询接口

接口说明根据模型ID获取排产结果信息

接口方法GET

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)、模型ID

返回值返【可应用是否正常运行的状态信息和模型生成的排产结果相关信息。

6.3.5排程结果确认提交接口

排程结果确认提交接口定义见发17：

表17排程结果确认提交接口定义

接口名称排程结果确认提交接1」

接口说明确认提交排程结果信息

接口方法POST

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)＞排程结果

返回值返回应用是否正常运行的状态信息

6.3.6物流列表查询接口

物流列表查询接口定义见表18：

表18物流列表查询接口定义

接口名称物流列表查询接口

接口说明根据登录账号ID获取物流列表信息

接口方法GET

参数说明至少包括：系统ID(syslemCode)、项目ID(gdCode)

返回值返回应用是否正常运行的状态信息和外协外购件物流列表

6.3.7项目外协外购件数量杳询接口

项目外协外购件数量查询接I1定义见表19：

表19项目外协外购件数量查询接口定义

接口名称项H外协外购件数量查询接口

接口说明根据项目ID获取外协外购件数量信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)

返回值返回应用是否正常运行的状态信息和项目外协件和外购件数量信息

6.3.8项目外协外购件清单内容查询接口

项目外协外购件清单内容查询接口定义见表20：

表20项目外协外购件清单内容查询接口定义

接口名称项目外协外购件清单内容查询接口

接口说明根据项目ID获取外协外购件清单信息

接口方法GET

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)

返回值返Pl应用是否正常运行的状态信息和项目外协外购件清单

7

T/BIAIMXXXXX-20XX

6.3.9项目外协外购信息查询接口

项目外协外购信息查询接口定义见表21：

表21项目外协外购信息查询接口定义

接LJ名称项目外协外购信息查询接LI

接口说明根据项目ID获取外协外购相关技术信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目所有外协外购件的技术信息、供

返回值

应链资源协同、进度协同信息等

6.4运维协同接口

6.4.1运维需求提报接口

运维需求提报接口定义见表22：

表22运维需求提报接口定义

接口名称运维需求提报接口

接口说明确认运维需求相关信息

接口方法POST

至少包括：系统ID(systemCode)、项目ID(gdCode)、服务请求编号、现

参数说明

场联系人、联系电话、服务地点、区域、信息来源

返回值返回应用是否正常运行的状态信息

6.4.2项目需求内容查询接口

项目需求内容查询接口定义见表23：

表23项目需求内容查询接口定义

接口名称项目需求内容查询接口

接口说明根据项目ID获取运维需求内容信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目下的所有人员或备件需求内容，

返回值

含响应情况

6.4.3项目及设备信息查询接口

项目及设备信息查询接口定义见表24：

表24项目及设备信息查询接口定义

接口名称项H及设备信息查询接口

接口说明根据项目ID获取项目及设备相关信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目及设备相关信息，包括项目背景、

返回值

工程进度、装备实时参数等信息。

6.4.4实时数据加载接口

实时数据加载接口定义见表25：

8

T/BIAIMXXXXX-20XX

表25实时数据加载接口定义

接口名称实时数据加载接口

接口说明根据项目ID获取实时运行信息

接口方法GET

参数说明至少包括:系统ID(systemCode)、项目ID(gdCode)

返回应用是否正常运行的状态信息和项目获取的实时运行参数和监测结果

返回值

等

6.4.5异常工况事件查询接口

异常工况事件查询接口定义见表26：

表26异常工况事件查询接口定义

接口名称异常工况事件查询接口

接口说明根据异常工况ID获取该工况详细信息

接口方法GET

参数说明至少包括：系统ID(systemCode)、项目ID(gdCode)＞异常工况ID

返回应用是否正常运行的状态信息和项Fl异常工况的详细信息，包括异常

返回值

工况名称、关联数据、判断时间等

6.4.6异常工况确认接口

异常工况确认接口定义见表27：

表27异常工况确认接口定义

接口名称异常工况确认接口

接口说明确认异常工况事件相关信息

接口方法POST

至少包括：系统ID(systemCode)、项目ID(gdCode)＞异常工况事件［I)、

参数说明

判断时间、核查结果、原因分析、优化建议等

返回值返回应用是否正常运行的状态信息

7接口安全

7.1结构安全

结构安全要求包括：