异步设点¶

异步多点设定测点值。

请求格式¶

PUT http://{apigw-address}/edge-service/v1/commands?action=setMeasurepointAsync&orgId={}

请求参数（URI）¶

请求参数 (URI)¶
名称	位置 (Path/Query)	是否必须	数据类型	描述
orgId	Query	是	String	资产所属的组织ID。如何获取orgId信息>>
action	Query	是	String	setMeasurepointAsync

请求参数（Body）¶

请求参数 (Body)¶
名称	是否必须	数据类型	描述
data	True	Object	设定测点值的相关信息。结构见下表。

data结构¶
名称	是否必须	数据类型	描述
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
        }
    ]
}