电化学储能电站安全信息监测系统数据格式要求、运行评价体系指标、上传信息内容.pdfVIP

GB/TXXXXX—XXXX

附录A

（规范性附录）

数据格式要求

A.1数据类型

各层级平台间传输的数据类型见表A.1。

表A.1数据类型

数据类型描述及要求

String字符串，使用双引号定义，可以包含零个或多个Unicode字符以及转义字符。

Number数字，使用IEEE-754双精度浮点格式来定义数字。

Boolean布尔值，true（真）或false（假）。

null空，表示没有任何值。

Array数组，由方括号[]和其中的若干值组成，值可以是JSON中支持的任意类型。

对象，由花括号{}以及其中的若干键/值对组成，一个对象中可以包含零个或多

Object

个键/值对。

A.2数据包结构及定义

A.2.1传输协议

数据传输接口应采用HTTPS协议、JSON格式，每个接口的URL应包含版本号、所请求调用

接口的名称，每个URL只允许对应一种功能。

A.2.2调用方式

各层级平台间的接口应使用HTTPS/POST方式传输，传输过程中应包含消息头和消息主体

两部分。

A.2.3消息头规范

消息头一般需包含内容类型（Content-Type）和授权信息（X-Authorization）、时间

戳（X-Timestamp）、签名(X-Sign）、随机值（X-Nonce）、应用Id(X-AppId），见表A.2。

表A.2header消息头信息表

header描述

Content-Type用于标识请求中的消息主体的编码方式，

Content-Type为application/json；charset=utf-8

X-Authorization授权信息采用令牌（token）方式，值为身份认证接

口返回的bearertoken

X-Timestamp时间戳，毫秒，接口发起调用时间，平台判断在一

个时间范围内有效，超出后失效

X-Nonce全局唯一随机值，用于判定重放攻击

X-Sign数字签名，参数内容使用对称加密算法（SM4）加密

后，按照X-AppId、X-Timestamp、X-Nonce、加密内

容的顺序，将对应的值拼接成字符串用SM3生成sign

签名。

X-AppId应用id

A.2.4消息主体

12

GB/TXXXXX—XXXX

(1)请求参数格式

参数内容（data）使用对称加密算法（SM4）加密。消息主体内容见表A.3。

表A.3消息主体内容表

参数名说明举例

data各接口具体参数信息

(2)返回值格式

由结果标识（RetCode）、返回信息（R