异步设点¶
异步多点设定测点值。
请求格式¶
PUT http://{apigw-address}/edge-service/v1/commands?action=setMeasurepointAsync&orgId={}
请求参数(URI)¶
名称 | 位置 (Path/Query) | 是否必须 | 数据类型 | 描述 |
---|---|---|---|---|
orgId | Query | 是 | String | 资产所属的组织ID。 如何获取orgId信息>> |
action | Query | 是 | String | setMeasurepointAsync |
请求参数(Body)¶
名称 | 是否必须 | 数据类型 | 描述 |
---|---|---|---|
data | True | Object | 设定测点值的相关信息。结构见下表。 |
名称 | 是否必须 | 数据类型 | 描述 |
---|---|---|---|
requestId | True | String | 设定测点值请求的标识符 |
orgId | True | String | OU的ID |
callType | False | String | 调用类型,值为 ASYNC ,表示异步 |
setMeasurepointChannelId | True | String | 设定测点值使用的通道ID |
productKey | True | String | 测点所属产品的product key,用于与 deviceKey 一起使用以指定一个设备资产 |
deviceKey | True | String | 测点所属产品的device key,用于与 productKey 一起使用以指定一个设备资产 |
assetId | True | String | 测点所属设备资产的asset ID,用于指定一个设备资产 |
measurepointId | True | String | 目标测点的ID |
callbackUrl | False | String | 回调函数URL |
inputData | False | Object | 输入数据,由输入数据键值对组成 |
timeout | False | Long | 超时时间,单位为毫秒,默认30000,最大300000 |
gmtSetMeasurepointRequest | False | Long | 调用者设定的设定测点值的时间,为精确到毫秒的UNIX时间戳,如果值为空或不大于0,则取当前系统时间 |
transferWay | False | Integer | 0表示数据实时上送,1表示数据变化上送,默认值为0 |
注解
在 subscribePointList `` 对象中,优先以 ``assetId
来确定设备。如果 assetId
不存在,则以 deviceKey
+ productKey
的组合来确定设备。
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
status | Int | 响应状态码 |
msg | String | 返回消息,用于描述响应结果 |
submsg | String | 返回子消息,用于描述响应结果 |
data | Object | 响应数据object,结构见下表 |
名称 | 数据类型 | 描述 |
---|---|---|
requestId | String | 设定测点值请求的标识符 |
orgId | String | OU的ID |
callType | String | 调用类型, SYNC 表示同步, ASYNC 表示异步 |
setMeasurepointChannelId | String | 写入测点使用的通道ID |
productKey | String | 测点所属产品的product key,用于与 deviceKey 一起使用以指定一个设备资产 |
deviceKey | String | 测点所属产品的device key,用于与 productKey 一起使用以指定一个设备资产 |
assetId | String | 测点所属设备资产的asset ID,用于指定一个设备资产 |
measurepointId | String | 目标测点的ID |
callbackUrl | String | 回调函数URL |
inputData | Object | 输入数据,由输入数据键值对组成 |
status | Int | 设定测点的结果,0表示成功,其他值表示失败 |
msg | String | 返回消息,对 status 的描述 |
submsg | String | 返回子消息,对 status 的描述 |
timeout | Long | 超时时间 |
gmtSetMeasurepointRequest | Long | 设定测点值的时间,精确到毫秒的UNIX时间戳 |
gmtSetMeasurepointReply | Long | 服务响应时间,精确到毫秒的UNIX时间戳 |
transferWay | Integer | 0表示数据实时上送,1表示数据变化上送,默认值为0 |
注解
在 subscribePointList `` 对象中,优先以 ``assetId
来确定设备。如果 assetId
不存在,则以 deviceKey
+ productKey
的组合来确定设备。
输入输出示例¶
请求示例¶
PUT http://{apigw-address}/edge-service/v1/commands?action=setMeasurepointAsync&orgId={}
{
"data":[
{
"requestId":"dfsadfdsafdsaf",
"orgId":"adadad",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.afdasfasdf",
"productKey":"dfasdf",
"deviceKey":"dsfa",
"assetId":"aaa",
"measurepointId":"bbb",
"callbackUrl":null,
"inputData":{
"arg":10
},
"timeout":30000,
"gmtSetMeasurepointRequest":132132465464
},
{
"requestId":"12321321321",
"orgId":"adadad",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.afdasfasdf",
"productKey":"dfasdf",
"deviceKey":"dsfa",
"assetId":"aaa",
"measurepointId":"ccc",
"callbackUrl":null,
"inputData":{
"arg":11
},
"timeout":30000,
"gmtSetMeasurepointRequest":132132465464
}
]
}
响应示例¶
{
"status":0,
"msg":"Success",
"submsg":null,
"data":[
{
"requestId":"testRequestId1",
"orgId":"aaa",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.setMeasurepointChannelId1",
"productKey":"6Bt59ySj",
"deviceKey":"zBAofs6D4s",
"assetId":"YCdyvNmc",
"measurepointId":"measurepointId1",
"callbackUrl":null,
"inputData":{
"testArg":1.0
},
"status":1000,
"msg":"para error",
"submsg":"para error",
"timeout":30000,
"gmtSetMeasurepointRequest":1536638267507,
"gmtSetMeasurepointReply":1536638267509,
"transferWay":0
},
{
"requestId":"testRequestId2",
"orgId":"aaa",
"requestMethod":"thing.service.d",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.setMeasurepointChannelId1",
"productKey":"6Bt59ySj",
"deviceKey":"zBAofs6D4s",
"assetId":"YCdyvNmc",
"measurepointId":"measurepointId2",
"callbackUrl":null,
"inputData":{
"testArg":1.0
},
"status":1000,
"msg":"para error",
"submsg":"para error",
"timeout":30000,
"gmtSetMeasurepointRequest":1536638267507,
"gmtSetMeasurepointReply":1536638267509,
"transferWay":0
}
]
}