写实时数据 · 汇川工业云使用手册

[TOC=2] ## 接口说明修改指定设备的实时数据。 1. 该接口暂不支持以下控制器：汇川(INOVANCE)中的HMI 1. 该接口暂不支持数据类型为字符串的读写 ## URL https://open.dataserver.cn/rest/api ## 公共请求参数 | 参数名称 | 数据类型 | 是否必选 | 描述 | | --- | --- | --- | --- | | method | String | 是 | **参数说明**：API接口名称，固定取值为real.writeRealTimeData。 | | appKey | String | 是 | **参数说明**：密钥，云平台分配给应用的密钥。 | | timestamp | String | 是 | **参数说明**：时间戳，请求调试的开始时间。 **说明**：时区为GMT+8，格式为yyyy-MM-dd HH:mm:ss，如：2015-01-01 12:00:00。 | | version | String | 是 | **参数说明**：版本，API协议版本。 **默认值**：1.0| | sign | String | 是 | **参数说明**：签名，根据API输入参数计算得到的签名，算法介绍请参见[签名算法](API配置.md)。 **说明**：签名有效期为3分钟。| ## 业务请求参数 | 参数名称 | 数据类型 | 是否必选 | 描述 | | --- | --- | --- | --- | | serialNo | String | 是 | **参数说明**：设备序列号，可通过“**设备管理>设备列表”的返回参数**“serialNo”字段中获取对应的设备序列号。 | | writeParams | String | 是 | **参数说明**：写参数的集合，参数包含：elementName和value。**输入格式**： [{"elementName":"xx",value:"xx"},{"elementName":"xx",value:"xx"}...] | | elementName | String | 是 | **参数说明**：元件名称。即在“**监控配置>开发包管理**”的“编辑云协议”中自定义的元件名称。 | | value | String | 是 | **参数说明**：值。**输入格式**：十进制数值。 | ## 请求示例 ``` { "method": "real.writeRealTimeData", "appKey":"App-163162079333-76060", "timestamp":"2021-09-09 19:54:20", "version" : "1.0", "serialNo":"liuming-modbus", "writeParams":'[ { "elementName":"16无符号枚举", "value":1 }, { "elementName":"16无符号电量", "value":2 } ]', "sign": "1781a26820af4fcf5f2719426fc68dba" } ``` ## 返回参数 | 参数名称 | 数据类型 | 描述 | | --- | --- | --- | --- | | code | Int | 响应状态。 | | msg | String | 响应结果的描述。 | ## 返回示例 ``` { "msg": "success", "code": 200 } ```