根据命令模板下发设备命令

• API
• 授权
• 路径参数
• Query参数
• Body参数
• Body示例
• 返回示例

API

使用已创建的命令模板对某个设备下发命令。传入的数据内容是一个JSON字符串，其中每个字段的数据类型都需要和模板对应字段类型相匹配，否则校验不通过。

请求路径	Request
POST /devices/{deviceKey}/commands/{identifier}	DeviceCommandSendTemplateRequest

命令下发数据最大大小为: 4Kb

授权

当前API可使用授权类型与具体的授权参数请参考下表（多个授权类型可任选一个）。了解更多请查看平台鉴权。

授权类型	授权参数	封装授权参数(调用HanCloudsClient提供的方法来封装)
用户	userKey / authKey / authSecret	putUserAuthParams()方法
产品	productKey / cmdKey / cmdSecret	putProductAuthParams()方法
设备	deviceKey / cmdToken	putDeviceAuthParams()方法
项目	projectKey / projectAuthKey / projectAuthSecret	putProjectAuthParams()方法

路径参数

参数名	类型	是否必须	说明
deviceKey	String	是	设备唯一Key
identifier	String	是	命令模板的唯一标识

Query参数

参数名	类型	是否必须	说明
validTime	Integer	否	平台保存命令的时间，默认为0。设备在线时该字段不生效，会直接下发到设备，而设备离线时默认不保存该命令

Body参数

参数名	类型	是否必须	说明
content	String	是	能够匹配命令模板的具体命令内容，JSON字符串

Body示例

"{\"p1\":{\"p12\":\"test\",\"p11\":10}}"

返回示例

返回值为commandId字符串。

7afd080dbb4948d6aedcaf265c9e8fb5