创建一个任务
HTTP请求地址: http(s)://api.yoyoiot.cn/{AppID}/task/create/?sign={sign}&ts={ts}
关于sign和ts的定义
或
MQTT发布主题: api/{AppID}/task/create
接收返回结果亦在同一主题
请求参数
接受POST和JSON方式
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| devices | 是 | string | 任务控制的设备、分组或标签的ID列表,可以传数组,也可以传用","或"|"间隔的字符串。
需要注意的是,如果设备清单里不只有设备,还存在分组或标签。就需要对应的ID前增加前缀,来区分类型:设备的ID前添加d_,在分组ID前添加g_,标签的ID前添加t_。
如任务需要:
控制ID为1001,1002两台设备,{"devices":[1001,1002]} 或 devices="1001,1002";
控制ID为1001设备和ID为100的分组,{"devices":["d_1001","g_100"]} 或 devices="d_1001,g_1002" |
| type | 是 | string | 任务策略类型,枚举值,可选值为:
datetime: 固定时间执行
minute: 每分钟执行
hour:每小时执行
day:每天执行
week:每周执行
month:每月执行
loop:间隔时间执行 |
| times | 否 | int | 执行次数,>=0 的整数,非必传
当任务类型为“固定时间执行”时,times会强制被置为1;当会其他任务类型时,默认为0 |
| 策略参数 | 是 | string | 当指定策略后,请根据上面的策略类型值来传入相应的参数,详见下面的说明 |
| 执行内容 | 是 | string | 任务执行的内容:可以是一段命令或一个动作。
当为命令时:传commands值,格式json
当为动作时:传action的ID,格式整型 |
| enable | 否 | int | 任务是否马上生效,可选值为:0或1,或不传
如不传,则立即生效 |
返回示例
返回结果
| 名称 | 类型 | 说明 |
|---|---|---|
| code | string | 返回状态值,200正确,其他错误请见接口首页“全局错误代码” |
| data | string | 创建成功的任务ID |
| msg | string | 返回状态信息 |