/接口文档
/工业数据服务接口
/实时服务接口

实时服务接口

版本记录

版本号日期修改内容
v0.14.22024-08-30修复已知问题

实时服务

单测点读值

接口功能

读取实时库单个测点的当前值。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/{nodeId}
http 请求方式get

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1nodeIdString是测点名列表，格式为“命名空间:测点名”，如“100:AI001.PV”
  1. 请求示例
get {Server}/v1/rtdata/node/100:AI001.PV

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsReadDataValue返回的结果

ReadDataValue结构定义如下：

名称类型说明
nodeIdString测点名
stlong原始测点值变化时间，Unix 时间戳，精确到毫秒
tlong实时服务返回的时间，Unix 时间戳，精确到毫秒
qint测点值质量位
vJson 基本数据类型值
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : {
       “nodeId”: “100:AI001.PV”,
	    “st” : 1627281919157,
        “t” : 1627281919157,
“q” : 1,
“v”:11.1,
}
}

多测点多项读值

接口功能

读取实时库测点的当前值，支持批量读取。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/read
http 请求方式post

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1nodeIdString[]是测点名列表，格式为“命名空间:测点名”，如“100:AI001.AV”，单次最大读取点数为 1000。
  1. 请求示例
{
    “nodeIds”: [“100:AI001.PV”, “100:EQ001.DI001.PV”]
}

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsReadDataValue[]返回的结果列表
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : [{
       “nodeId”: “100:AI001.PV”,
	    “st” : 1627281919157,
        “t” : 1627281919157,
“q” : 1,
“v”:11.1,
},
{
    “nodeId”: “100:EQ001.DI001.PV”,
“st” : 1627281919157,
        “t” : 1627281919157,
“q” : 1,
“v”:true,
}]
}

多测点多点项写值

接口功能

向实时库测点写值，支持批量写入。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/write
http 请求方式post

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1dataString[]是写值对象列表

WriteDataValue定义如下：

属性名称类型说明
nodeIdString测点名，格式为“命名空间:测点名”，如“100:AI001.PV”
valueJson 基本数据类型值
  1. 请求示例
“data” : [
 {
“nodeId”: “100:AI001.PV”,
“value”:12.1
},
{
“nodeId”: “100:EQ001.DI001.PV”,
“value”:false
}
]

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsint []每个测点写入结果状态码列表，0 表示成功，其他失败
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : [0,0]
}

点强制

接口功能

对测点进行强制。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/force
http 请求方式post

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1dataWriteDataValue []是强制对象列表，WriteDataValue定义如上
  1. 请求示例
“data” : [
 {
“nodeId”: “100:AI001.PV”,
“value”:12.1
},
{
“nodeId”: “100:EQ001.DI001.PV”,
“value”:false
}
]

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsint []每个测点强制结果状态码列表，0 表示成功，其他失败
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : [0,0]
}

取消强制

接口功能

对测点取消强制。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/unforce
http 请求方式post

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1nodeIdsString[]是测点名列表，格式为“命名空间:测点名”，如“100:AI001.AV”，单次最大点数为 1000。
  1. 请求示例
{
    “nodeIds”: [“100:AI001.PV”, “100:EQ001.DI001.PV”]
}

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsint []每个测点取消强制结果状态码列表，0 表示成功，其他失败
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : [0,0]
}

点禁止

接口功能

对测点进行禁止操作。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/disable
http 请求方式post

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1nodeIdsString[]是测点名列表，格式为“命名空间:测点名”，如“100:AI001.AV”，单次最大点数为 1000。
  1. 请求示例
{
    “nodeIds”: [“100:AI001.PV”, “100:EQ001.DI001.PV”]
}

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsint []每个测点禁止结果状态码列表，0 表示成功，其他失败
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : [0,0]
}

取消禁止

接口功能

对测点取消禁止。

接口类型

HTTP 接口

接口地址

URL{Server}/v1/rtdata/node/undisable
http 请求方式post

请求参数

  1. 请求参数说明
序号名称类型是否必填描述
1nodeIdsString[]是测点名列表，格式为“命名空间:测点名”，如“100:AI001.AV”，单次最大点数为 1000。
  1. 请求示例
{
    “nodeIds”: [“100:AI001.PV”, “100:EQ001.DI001.PV”]
}

执行结果

  1. 返回值参数说明
名称类型描述
codeint返回码，0 成功，其他失败
messageString返回信息描述
resultsint []每个测点取消禁止结果状态码列表，0 表示成功，其他失败
  1. 示例说明
{
“code” : 0,
“message” : “success”,
“results” : [0,0]
}