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