控制分组执行命令或动作
HTTP请求地址: http(s)://api.yoyoiot.cn/{AppID}/group/control/?sign={sign}&ts={ts}
关于sign和ts的定义
或
MQTT发布主题: api/{AppID}/group/control
接收返回结果亦在同一主题
请求参数
参数较长时建议使用POST方式
| 名称 | 类型 | 说明 |
|---|---|---|
| group | int | 分组ID,读取分组列表时返回的ID |
| 命令或动作 | string | 命令和动作只能同时指定一个,二选一
当指定命令时:格式为 设备的属性名称=属性值
在设备详情页,可查询设备的可用指令以及可用的值
如power=1,则下发命令接通分组设备电源
也可以将属性值用order包裹起来,如:order:{power:1}
当指定动作时:格式为 action=动作id
如action=1,则对应分组执行id为1的动作 |
返回示例
返回结果
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 200 正确
501 未指定分组ID,分组ID为一个整型数字。分组列表接口中输出了此ID,在本控制台的设备列表中也可以查看。
502 分组不存在或没有可用设备。请检查分组ID是否正确,分组中是否添加设备和对应的指令。
504 一次指定了多个分组ID
504 没有可识别的指令 指令中的功能不存在,请在产品列表中的指定产品的功能列表中,查看可用功能。
50xx 请见“全局错误代码” |
返回示例