创建一个任务
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
返回状态信息