ICS35.240.50 CCSJ07 中华人民共和国国家标准 GB/T43960—2024 云制造服务平台开放接口要求 Openapplicationprograminterfacerequirementsfor cloudmanufacturingserviceplatform 2024-04-25发布 2024-11-01实施 国家市场监督管理总局 国家标准化管理委员会发布目 次 前言 Ⅲ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语和定义 1 ……………………………………………………………………………………………… 4 缩略语 1 …………………………………………………………………………………………………… 5 开放接口模型 2 …………………………………………………………………………………………… 6 接口类型 3 ………………………………………………………………………………………………… 7 接口编写要求 9 …………………………………………………………………………………………… 8 接口设计要求 10 …………………………………………………………………………………………… 9 接口注册与调用要求 10 …………………………………………………………………………………… 10 数据包格式 11 …………………………………………………………………………………………… 附录A(资料性) 云制造服务平台开放接口示例 13 ……………………………………………………… ⅠGB/T43960—2024 前 言 本文件按照GB/T1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规 定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中国机械工业联合会提出。 本文件由全国自动化系统与集成标准化技术委员会(SAC/TC159)归口。 本文件起草单位:北京航天智造科技发展有限公司、江苏省工业互联网发展研究中心、贵州航天云 网科技有限公司、苏州申浪信息科技有限公司、北京机械工业自动化研究所有限公司、清华大学、贵州大 学、北京航空航天大学、贵州溪山科技有限公司、中科云谷科技有限公司、中国科学院自动化研究所、重 庆大学、江苏中车数字科技有限公司、南京航空航天大学、联通数字科技有限公司、广州机智云物联网科 技有限公司、贵州鸿巨热力(集团)有限责任公司、北京工业大学、贵州中车绿色环保有限公司、航天精工 股份有限公司、北京科技成果转化服务中心、河北宝力工程装备股份有限公司、湖南华博信息技术有限 公司、国家开放大学、浪潮通信技术有限公司、浙江第元信息技术有限公司、四川德恩云智造科技有限公 司、云智(天津)科技有限公司、北京信达远科技有限公司。 本文件主要起草人:杨灵运、张华、于文涛、王海丹、曹玉龙、谷牧、赵千川、杨静、冯泽军、任磊、尹作重、 张昌福、杨文峰、周志忠、唐敦兵、孙洁香、姜海森、石伟、王发华、陈世超、李孝斌、黄灼、邢雁、吕宜生、曲涛、 景宁、许培炎、王琢璞、金一帆、冯濒元、周恢、朱海华、张泽群、薛舒允、潘明波、杨杰、石娇、严海蓉、刘希亮、 宿春慧、王旭亮、王紫程、胡丙齐、龚博翔、石永、甄伟、罗向阳、赵建林、田志、袁卓异、陈海锋、谢龙德、 陆小斌、王洪臻。 ⅢGB/T43960—2024 云制造服务平台开放接口要求 1 范围 本文件规定了云制造服务平台的开放性应用程序编程接口模型、接口类型与设计编写要求,为云制 造服务平台的开发者提供指导。 本文件适用于指导云制造服务平台的制造资源/能力接入、微服务/APP应用开发有关接口的开 发、调用与测试。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文 件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于 本文件。 GB/T29826—2013 云制造 术语 GB/T39471—2020 云制造服务平台制造资源接入集成规范 GB/T39403—2020 云制造服务平台安全防护管理要求 3 术语和定义 GB/T29826—2013界定的以及下列术语和定义适用于本文件。 3.1 开放接口 openapplicationprograminterface 云制造服务平台对外提供的开放性应用程序编程接口。 3.2 工业应用服务接口 applicationprograminterfaceforindustrialapplication 在云制造服务平台上,提供的支持工业应用开发和管理等方面的开放性应用程序编程接口。 3.3 制造资源/能力接入接口 applicationprograminterfaceformanufacturingresource/capabilityimport 在云制造服务平台上,为云制造资源/能力接入到平台,提供的支持数据传输、资源管理、标识管理 等方面的开放性应用程序编程接口。 4 缩略语 下列缩略语适用于本文件。 API:应用程序编程接口(ApplicationProgrammingInterface) APP:应用程序(Application) ERP:企业资源计划(EnterpriseResourcePlanning) HTTP:超文本传输协议(HyperTextTransferProtocol) 1GB/T43960—2024 HTTPS:超文本传输安全协议(HypertextTransferProtocolSecure) ID:身份标识号(Identification) MES:生产制造过程执行系统(ManufacturingExecutionSystem) OWASP:开放式Web应用程序安全项目(OpenWebApplicationSecurityProject) PLM:产品生命周期管理(ProductLifecycleManagement) POST:HTTP协议的POST方法(Post) PUT:HTTP协议的PUT方法(Put) SLA:服务等级协议(Service-LevelAgreement) SCADA:数据采集与监视控制系统(SupervisoryControlAndDataAcquisition) 5 开放接口模型 5.1 通则 云制造服务平台开放接口模型架构见图1,包括工业应用服务接口和制造资源/能力接入接口两大 类开放接口。制造资源/能力接入方面应符合GB/T39471—2020第6章~第8章的规定。接口安全 方面应符合OWASP、GB/T39403—2020的相关规定。 两大类接口可使用HTTP、HTTPS等传输协议,宜遵守OpenAPISpecification、SLA等规范。 图1 开放接口模型 5.2 工业应用服务接口 工业应用服务接口分为工业应用开发接口和工业应用管理接口,其中工业应用开发接口包括数据 类接口、模型类接口和微服务类接口,应明确工业应用开发调用的数据、模型和微服务的接口;工业应用 管理接口应包括应用管理类接口和安全类接口,应提供应用部署、监控管理、身份认证、访问控制、权限 管理等方面的接口。 2GB/T43960—2024