# 创建定时任务 * **说明** > 添加一条定时任务信息，成功后返回定时任务的ID。 * **URL**：/v1/timetask/add * **请求方式**：POST * **Header参数**： | **Header\_Key** | **Header\_Value** | | :---: | :---: | | **ts** | 精确到ms的时间戳 | | **openid** | openid，每个个人用户的唯一标识 | | **applicationid** | 应用ID，每个开发者的唯一标识 | | **sign** | 加密签名，算法为SHA1\(HTTPMethod+RequestURI+params+ts+openkey+applicationkey\) | * **请求内容**： | **参数名称** | **中文名称** | **类型** | **限制** | **必须** | **说明** | | :--- | :---: | :---: | :---: | :---: | :--- | | **did** | 设备ID | 字符串 | 18 | 是 | 设备ID | | **as** | 属性集 | JSON对象 | 无 | 是 | 属性集 | | **enable** | 有效标志位 | 整型 | 无 | 否 | 0无效1有效，不传默认设置为1 | | **note** | 说明 | 字符串 | 128 | 否 | 定时器说明 | | **type** | 定时器类型 | 整型 | 1 | 是 | 定时任务类型，1为周期性的，2为一次性的 | | **period** | 执行周期 | 整型 | 256 | 否 | type=1时必须传入，表示周几执行，传入十进制整数，转换成七位0/1数字表示,如1010101 | | **time** | 距离时间 | 整型 | 1 | 是 | 表示任务执行时间点距离零点零分零秒的秒数，比如00:01:01则传入61 | > 例如： ``` { "did":"deviceId", "as":{"1":1,"2":2}, "enable":1, "expired":true, "period":"0", "time":5690, "type":2, "note":"" } ``` * **返回内容** **成功时：** > 返回内容 ``` { "code": 0, "taskId":"123" } ``` > 返回说明 | **参数名称** | **中文名称** | **类型** | **说明** | | :--- | :--- | :--- | :--- | | **taskId** | 定时任务ID | 字符串 | 32位随机字符串 | **失败时：** ``` { "code": ERRORCODE //ERRORCODE可以去错误码目录中查找 } ```