初始化指标对应的opc-ua监测点，根据输入的监测点数据，删除系统中多余的监测点，如果输入的监测点已存在则更新，不存在则新增。

POST

/api/v1/opc-ua/init-communication

关键词：OPCUA、监测点、初始化
使用场景：此接口和OPC监测点修改接口/api/v1/opc-ua/update-communication的区别在于可进行差集修改，
若输入参数中有一条信息为：Node=“ns=2;s=Z3\Test\TestFlow.PV”,OPCFlag=“OPCTest”，在数据库中不存在，则新增该监测点数据，若存在则修改；
若该条数据只存在在数据库中，输入参数中没有，则删除数据库中的该条数据
输入：opc-ua监测点信息列表
输出：是否成功

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

array of:

indicatorId

string <uuid>

可选

设备指标Id，对应着设备-指标，可通过查询映射服务获取

nodeName

string | null

可选

节点名称，如:主线静压式液位

node

string | null

可选

节点检测项，如:ns=2;s=Z3\Test\TestWL.PV

unit

string | null

单位,如:m³/s

可选

dataType

enum<integer> <int32>

可选

0-BoolValue
1-DateTimeValue
2-DblValue
3-LongValue
4-StrValue
5-FloatValue
6-UInt32Value
7-UInt16Value
8-Int32Value
9-Int16Value

枚举值:

0123456789

decimalPlaces

integer <int32>

小数点数,默认为2

可选

timeProcessingMode

enum<integer> <int32> | enum<null>

可选

时间处理模式：秒、分、小时、默认原始值,不做处理

枚举值:

0123

isOpenSync

boolean

可选

是否启用同步，同步则根据时间步长定时调用同步接口，默认不同步

period

integer <int32> | null

可选

时间步长，IsOpenSync为true，则需要设置时间步长

opcFlag

string | null

可选

标识,OpcUaConfig表的OpcFlag

isRealData

boolean

可选

是否是实时数据，若为实时数据，则该节点自动添加订阅

subKey

string | null

可选

subkey为设备名称|检测指标|tenantid,如：测试水厂出厂|ceshi_1_shuichang_flow|3a0d4cc8-9a68-1658-ae5e-e6c969eb66ea

示例

[
    {
        "indicatorId": "234d31af-d293-e107-54a4-f2725c9d969e",
        "nodeName": "主线流量",
        "node": "ns=2;s=Z3\\Test\\TestFlow1.PV",
        "unit": "m³/s",
        "dataType": 2,
        "decimalPlaces": 2,
        "timeProcessingMode": 1,
        "isOpenSync": true,
        "period": 5,
        "opcFlag": "OPCTest",
        "isRealData": true,
        "subKey": "测试水厂出厂|ceshi_1_shuichang_flow|3a0d4cc8-9a68-1658-ae5e-e6c969eb66ea"
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://online-products.dhichina.cn/gateway/iot-service/api/v1/opc-ua/init-communication' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "indicatorId": "234d31af-d293-e107-54a4-f2725c9d969e",
        "nodeName": "主线流量",
        "node": "ns=2;s=Z3\\Test\\TestFlow1.PV",
        "unit": "m³/s",
        "dataType": 2,
        "decimalPlaces": 2,
        "timeProcessingMode": 1,
        "isOpenSync": true,
        "period": 5,
        "opcFlag": "OPCTest",
        "isRealData": true,
        "subKey": "测试水厂出厂|ceshi_1_shuichang_flow|3a0d4cc8-9a68-1658-ae5e-e6c969eb66ea"
    }
]'

返回响应

🟢200成功

text/plain

Success

Body

boolean

可选

示例

成功示例异常示例

true

修改于 2025-07-14 05:55:00

查询指标对应的opc-ua监测点，用于项目配置平台显示

初始化指标对应的opc-ua监测点,如果存在则全部删除后再添加