说明

添加一个预约任务/周期任务。

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

  • 按设备上的按钮可以暂停告警3分钟。
  • 长按设备上的按钮可以关闭告警,同时也会关闭设备上电源
  • 预约任务添加任务时,如果已经超过开始时间,电源会自动开启

周期任务:
定时任务会在开始时间开启电源,到结束时间会自动关闭电源

  • 周期任务超过结束时间会删除任务,无需调用删除任务接口
  • 如果添加任务时,已经超过开启时间,则电源不会开启。
  • 删除任务,插座会断电

接口地址

POST /api/ac/add-schedule?appid={APPID}

请求参数说明

名称 类型 必填 说明
appid string Y 管理员给用户创建的应用ID

Body 示例

 {
  "gwsn": "dcda0ccdcc3e",
  "is_cycle":false,
  "task_id": 1,
  "start": 1757660855,
  "end": 1767660949
 }

字段说明

名称 类型 必填 说明
gwsn string Y 网关序列号
is_cycle bool Y 是否周期任务(true:周期任务;false:预约任务)
task_id int Y 任务ID。不能有相同的任务ID
start int Y 开始时间戳
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
最后编辑:阮德明  更新时间:2026-01-23 16:08