批量下发命令到多个设备
调用下发同一命令到批量设备。不支持子设备。下发指令最多20条限制。可以对同一个设备下发不同的命令也可以对不同的设备批量下发命令。每次只下发data数组里一条指令,轮询发送。设备一次只能接收一条指令。返回每条指令是否下发成功。
请求URL:
curl"https://api.qinglianyun.com/open/oauth/v1/batch/set/api" -d"qlaccesstoken=xxxxxx&data=[{\"key\":\"xxx\",\"value\":\"xxx\"},{\"key\":\"xxx\",\"value\":\"xxx\"}]&mac=[\"xxxxxx\",\"xxxxxx\",\"xxxxxx\"]"
返回的 JSON 数据:
{
"code": 0,
"msg":"xxxxxxxxxxx",
"data":"[{\"id\":\"xxxx\", \"status\": 0},{\"id\":\"xxxx\", \"status\": 1}]"
}
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
mac | List | 设备的Mac列表 | 如:5c:cf:7f:c1:0b:fd | 是 |
qlaccesstoken | String | 青莲云用户账号的token | 青莲云每一个用户账号都是唯一的 | 是 |
data | json | 设置的数据 | 消息目前支持字符串格式 | 是 |
key | String | 数据点的变量名 | 设备所属产品的数据点属性 | 是 |
value | Sting | 数据点的值 | 设备所属产品的数据点的值 | 是 |
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
data | String | JSONArray格式的字符串 | 是 | |
code | Int | 返回码 | 查看Api返回码 | 是 |
msg | String | 返回信息 | 如果code为0,则msg为空;如果code不为0, 则msg返回的为相关错误信息 |
是 |
id | String | 设备mac | 如:5c:cf:7f:c1:0b:fd | 是 |
status | int | 发送状态 | 0不在线或者发送失败1发送成功 | 是 |