4. 命令下发_智能墙壁复合开关[左门右灯]产品手册

在平台开放的所有接口中，向设备下发命令是最核心、也是最常用的命令。
初次接入设备时，也建议先实现 “向设备下发命令” ，再通过其他接口实现另外的功能。

在向设备下发命令前，请先确定设备已连接网络，并在控制台显示在线。

在开始编写代码前，请做好以下准备工作：

1 已注册、并登录平台，并安装“物联网控制台”模块

2 设备已通电，上线，并在控制台可以控制

3 下载 / 安装一个类似Postman的接口请求工具（如无）

接口地址：

https://api.yoyoiot.cn/{AppID}/device/control/?sign={sign}&ts={ts}

{AppID} 为您的应用ID（由平台生成）请按准备工作的引导进入控制台，在开发设置页面查看。
{sign} 和 {ts} 的算法，请查看上一节中的描述

参数较长时建议使用POST方式

名称	必填	类型	说明
gateway	否	string	当发给设备的命令需要其关联的网关转发时，需要指定网关的设备ID，唯一ID（在网关壳体上、控制台均可以找到）指定多个网关时请用间隔符(,或\|)连接，最多可以同时指定5台网关
device	否	string	设备ID，设备唯一ID（在设备壳体上、控制台均可以找到）指定多台设备时请用间隔符(,或\|)连接指定多个设备时，不要这些设备属于同一类产品，但必须有相同的指令
order	否	string	命令，可传JSON字符串(推荐)或直接传参简单命令：可直接GET或POST：设备的属性名称=属性值复杂或较长的命令：请POST {"order":{命令内容}} ----------------------------------------------------------------------- 在一些业务场景，需要在命令里携带一些特征信息：如订单号等可在order中增加一个字段extra，如{"power":1,"extra":"T25030700001"} 在本条命令对应的异步消息推送中，会原样返回此特征信息。 extra只支持32位以内的大小写英文字母和数字（a-zA-Z0-9）

需要注意的是，200仅代表平台接收到了合规的设备ID与参数名称，并成功向设备下发命令。

而设备可能已离线，或命令内容 / 参数有误，在设备上并没有看到预期效果。

在一些必须要求反馈的场景，请接收云端的消息推送，通过异步消息来标记设备是否成功执行命令。

名称	类型	说明
code	int	200 命令下发成功。 501 未指定设备ID，设备ID为一个整型数字，或由“\|”或“,"连接的多个数字。设备列表接口中输出了此ID，在本控制台的设备列表中也可以查看。 502 设备不存在或没有可用设备，传入设备ID均不存在。请检查设备ID是否正确，设备是否删除。 503 指定了过多设备，一次最多指定100台设备ID 504 一次指定了多个设备ID，但其中有一些并不可用（不存在、无权限或已删除） 50xx 请见“全局错误代码”

编程方式：

智能墙壁复合开关[左门右灯]