说明
添加一个预约任务/定时任务。
预约任务:
预约任务到开始日期后,设备会自动通电。
预约任务到结束日期时,设备会鸣叫告警,用户需要发出指令删除预约任务,删除成功后,告警消失、设备断电。
- 按设备上的按钮可以暂停告警3分钟。
- 长按设备上的按钮可以关闭告警,同时也会关闭设备上电源
定时任务:
定时任务会定时开启电源,到结束时间会自动关闭电源
定时任务实际上创建了两个任务:
- 定时开启任务(如果start>0 taskid+=1)
- 定时关闭任务
接口地址
POST /api/ac/add-schedule?appid={APPID}
请求参数说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appid | string | Y | 管理员给用户创建的应用ID |
Body 示例
{
"gwsn": "dcda0ccdcc3e",
"is_timer":false,
"task_id": 1,
"start": 1757660855,
"end": 1767660949
}字段说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| gwsn | string | Y | 网关序列号 |
| is_timer | bool | Y | 是否定时任务(true:定时任务;false:预约任务) |
| task_id | int | Y | 任务ID。不能有相同的任务ID |
| start | int | N | 开始时间戳 |
| end | int | Y | 结束时间戳 |
回复数据
{
"code": 200,
"unikey": "5cb177d2-5527-4cd7-b906-300237e17e19",
"msg": "成功"
}回复字段说明
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int | Y | 200:成功,其它:异常。参考文档 通用返回值 |
| unikey | string | Y | 平台生成的唯一指令id |
| msg | string | Y | 消息说明 |
作者:阮德明 创建时间:2025-04-27 16:59
最后编辑:阮德明 更新时间:2025-12-12 10:25
最后编辑:阮德明 更新时间:2025-12-12 10:25