说明

添加一个预约任务/定时任务。

预约任务:
预约任务到开始日期后,设备会自动通电。
预约任务到结束日期时,设备会鸣叫告警,用户需要发出指令删除预约任务,删除成功后,告警消失、设备断电。

  • 按设备上的按钮可以暂停告警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