说明

设置定时任务

接口地址

POST /api/3ph/settimer?appid={AppID}

请求参数说明

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

Body 示例

{
  "gwsn": "94A9901BB884",
  "bresn": "B00600041350F4E3134525348",
  "on_timer": {
    "timer1":{
      "h": 16,
      "m": 9,
      "s": 44,
      "w": 0
    },
   "timer2":{
      "h": 16,
      "m": 9,
      "s": 44,
      "w": 0
    }
  },
  "off_timer": {
    "timer1":{
      "h": 17,
      "m": 9,
      "s": 44,
      "w": 0
    },
   "timer2":{
      "h": 18,
      "m": 9,
      "s": 44,
      "w": 0
    },
   "timer3":{
      "h": 0,
      "m": 0,
      "s": 0,
      "w": 0
    }
  }
}

Body 字段说明

名称 类型 必填 说明
gwsn string Y 网关序列号
bresn string Y 断路器序列号
on_timer object Y 定时开启时间设置
off_timer object Y 定时关闭时间设置

timer1 字段说明

字段名称 类型 说明
h int 小时，0-23
m int 分钟，0-59
s int 秒钟，0-59
w int 循环日期，0-127。例子：周日、一、二、三、四、五、六 分别是：1、2、4、8、16、32、64

回复数据

{
  "code": 200,
  "unikey": "f15b8ee1-ac32-4ca7-95bf-2a028b215f02",
  "msg": "成功"
}

回复字段说明

名称 类型 必填 说明
code int Y 200:成功，其它：异常。参考文档 通用返回值
unikey string N 任务id，用户回调接口推送的数据会带有此字段
msg string Y 消息说明
作者：阮德明  创建时间：2025-11-21 16:40
最后编辑：阮德明  更新时间：2025-12-12 10:25