ICS35.080 L77 工业APP开放接口要求 IndustrialAPPopeninterfacesrequirements 2020-08-25发布 2020-09-01实施 中国电子工业标准化技术协会发布团体标准 T/CESA1114—2020 全国团体标准信息平台 版权保护文件 版权所有归属于该标准的发布机构，除非有其他规定，否则未经许可，此发行物及其章节不得以其 他形式或任何手段进行复制、再版或使用，包括电子版，影印件，或发布在互联网及内部网络等。使用 许可可于发布机构获取。 全国团体标准信息平台 T/CESA1114-2020 I目  次 前言.......................................................................................................................................................................II 1范围.....................................................................................................................................................................1 2规范性引用文件.................................................................................................................................................1 3术语和定义.........................................................................................................................................................1 4缩略语.................................................................................................................................................................1 5工业APP开放接口框架.....................................................................................................................................2 6工业APP开放接口要求.....................................................................................................................................2 附录A（资料性）接口范例............................................................................................................................9 参考文献...............................................................................................................................................................11 全国团体标准信息平台 T/CESA1114-2020 II前  言 本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准文件的结构和起草规则》的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本文件由江苏赛西科技发展有限公司提出。 本文件由中国电子技术标准化研究院、中国电子工业标准化技术协会归口。 本文件起草单位：江苏赛西科技发展有限公司、中国电子技术标准化研究院、苏州同元软控信息技 术有限公司、江苏极熵物联科技有限公司、无锡信捷电气股份有限公司、中国航发控制系统研究所、中 国船舶重工集团公司第七〇二研究所、无锡微茗智能科技有限公司、中软国际科技服务南京有限公司、 常州天正工业发展股份有限公司。 本文件主要起草人：于秀明、张星星、刘奇、张旸旸、焦提兵、邢晓凡、刘国平、刘增志、王成、 尤杰、周凡利、李文鹏、魏振南、张翀昊、赵捷、田志峰、刘羿、叶宣辰、高晨、李伟、钱卫东、任暑 楚、陈大胜、沈涛、郑小勇。 全国团体标准信息平台 T/CESA1114-2020 1工业APP开放接口要求 1范围 本文件提出了工业APP开放接口要求，规定工业互联网APP对外开放接口的接口原则、接口框架及接 口要求，给出设计、仿真、管理等类型APP的开放接口示例。本文件不涉及工业APP内部接口内容。 本文件适用于工业APP之间通信互联、信息互通及功能上互操作，可供工业APP开发商、工业APP集 成服务商、工业APP测评机构等单位参考使用。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T11457信息技术软件工程术语 3术语和定义 GB/T11457中界定的以及下列术语和定义适用于本文件。 3.1 工业APPindustrialinternetapplication 基于工业互联网，承载工业知识和经验，满足特定需求的工业应用软件。 3.2 工业互联网平台industrialinternetplatform 工业互联网平台是面向制造业数字化、网络化、智能化需求，构建基于海量数据采集、汇聚、分析 的服务体系，支撑制造资源泛在连接、弹性供给、高效配置的工业云平台。 3.3 表述性状态转移representationalstatetransfer 一种针对网络应用的设计和开发方式，指的是一组架构约束条件和原则，可以降低开发的复杂性， 提高系统的可伸缩性。 4缩略语 下列缩略语适用于本文件。 HTTP：超文本传输协议(HypertextTransferProtocol) 全国团体标准信息平台 T/CESA1114-2020 2JSON：JavaScript对象简谱（JavaScriptObjectNotation） RDF：资源描述框架（ResourceDescriptionFramework） REST：表述性状态转移(RepresentationalStateTransfer) SSL：安全套接层（SecureSocketsLayer） URI：统一资源标识(UniformResourceIdentifier) XML：可扩展置标语言（ExtensibleMarkupLanguage） 5工业APP开放接口框架 工业APP是工业软件的一种新形态，为避免传统工业软件发展中出现的数据孤岛困境，工业APP 在发展初期就应进行顶层设计，对其对外开放接口提出要求，通过对开放接口的通信协议及操作进行规 范化、标准化，解决从工业APP中取数据、查数据、控数据的基本问题。 本文件所定义的工业APP开放接口主要作用是对工业APP对外的数据接口、控制接口及状态接口提供 统一的定义和访问方法。主要用途是为需求、设计、仿真、生产及经营等类型工业APP的互联互通场景 提供基础支撑。工业APP开放接口框架包含协议层、功能层和业务层，见图1。 图1工业APP开放接口框架 协议层：明确工业APP开放接口的通信协议，规定工业APP开放接口的设计风格。 功能层：在统一通信协议基础上，进一步定义一组基础功能集，为工业APP接口调用中的通用问题 提供统一的解决方案。本文件中的功能集实现不具有强制性，工业APP开发者可根据实际情况选择性实 现。附录A给出了不同工业APP功能层开放接口的例子。 业务层：在协议层、功能层基础上，工业APP开发者根据业务定义的系列开放接口。本文件不对具 体业务功能做出规定，通过给出典型工业APP开放接口实例作为参考。 6工业APP开放接口要求 全国团体标准信息平台 T/CESA1114-2020 36.1协议层 协议接口应采用REST架构风格定义，通过HTTP的方法动词（POST、GET、PUT和DELETE）提供REST 服务，所涉及的工业APP资源采用RDF/XML进行封装。HTTPURI格式定义为： <protocol>://<ip>:<port>/<URI>?p1=v1&p2=v2&…&pn=vn，其中，protocol支持http和https协议，ip 指主机地址或域名，port指http请求所用的端口号，URI路径是“<SERVICE>/<resource>”。 工业APP中的资源采用RDF格式进行表述。 示例：请求一个URI为http://xyourserver/entities/entity/1的资源，应返回如下格式的R