W733(三路4G卷帘门控制器)API

概述

W733 是 W73 自定义开关大类下的三路 4G 卷帘门控制器，序列号前缀为 W733。三路输出分别对应开门、停止、关门，支持点动模式和锁定模式。三路互相独立，操作任一路不会主动改变其它路状态。

通道 业务含义 点动命令 锁定命令 状态位
1 开门 open open_lockup cur_sw_sta[0]
2 停止 pause（兼容 stop） pause_lockup（兼容 stop_lockup） cur_sw_sta[1]
3 关门 close close_lockup cur_sw_sta[2]

cur_sw_sta 为三位字符串，1 表示该路输出高电平，0 表示低电平。例如 101 表示开门路和关门路为高，停止路为低。

1.注册设备

请求URL

https://wdev.wmj.com.cn/deviceApi/register

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}"
}

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}"
  }
}
2.查询三路输出状态

简要描述

查询 W733 三路输出当前状态。

请求URL

https://wdev.wmj.com.cn/deviceApi/send

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "get_sta",
    "info": {}
  }
}

参数说明

参数名 必填 类型 说明
app_id 是 string APIv2 应用 ID
app_secret 是 string APIv2 应用密钥
device_sn 是 string W733 设备序列号
type 是 number 固定传 1
data.cmd_type 是 string 固定传 get_sta
data.info 是 object 空对象

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "get_sta",
    "info": {
      "code": 0,
      "msg": "OK",
      "on_line": 1,
      "cur_sw_sta": "000"
    }
  }
}

备注

  • cur_sw_sta 三位依次表示开门、停止、关门。
  • 点动模式延时结束后，对应状态位会恢复为 0。
3.点动控制

简要描述

控制开门、停止、关门任一路输出拉高，延时后自动恢复低电平。默认延时为 1000ms，可通过本次请求的 delay 自定义。

请求URL

https://wdev.wmj.com.cn/deviceApi/send

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "open",
    "info": {
      "delay": 1000,
      "tts": "卷帘门正在打开"
    }
  }
}

参数说明

参数名 必填 类型 取值范围 / 格式 默认值 说明
data.cmd_type 是 string open / pause / close，兼容 stop 无 要点动的输出路
data.info.delay 否 number 100-30000，单位 ms 1000 本次输出拉高持续时间
data.info.tts 否 string 建议不超过 120 字符 默认提示语 本次控制后播报的语音文本

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "open",
    "info": {
      "code": 0,
      "msg": "OK"
    }
  }
}

备注

  • open 只控制开门路，pause 只控制停止路，close 只控制关门路；stop 作为兼容别名保留。
  • 如果同一路正在点动，再次下发点动会按新的延时重新计时。
  • 未传 tts 时使用默认提示语；同一路 tts 文本与上次一致时播放缓存音频，文本变化时重新合成并覆盖该路固定缓存。
4.锁定控制

简要描述

控制开门、停止、关门任一路输出保持高电平或恢复低电平。锁定模式不会自动恢复，需下发 enable: 0 取消。

请求URL

https://wdev.wmj.com.cn/deviceApi/send

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "open_lockup",
    "info": {
      "enable": 1,
      "tts": "卷帘门保持打开"
    }
  }
}

参数说明

参数名 必填 类型 取值范围 / 格式 说明
data.cmd_type 是 string open_lockup / pause_lockup / close_lockup，兼容 stop_lockup 要锁定控制的输出路
data.info.enable 是 number/string 1 / 0 1 拉高保持，0 恢复低电平
data.info.tts 否 string 建议不超过 120 字符 enable=1 时播报的语音文本

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "open_lockup",
    "info": {
      "code": 0,
      "msg": "OK"
    }
  }
}

备注

  • 锁定只影响当前命令对应的一路输出。
  • 示例：先下发 open_lockup enable=1，再下发 pause_lockup enable=1 后，状态应为 110。
  • 锁定模式仅 enable=1 时播报语音，enable=0 取消锁定不播报。
5.设置默认点动延时

简要描述

设置当前运行会话的默认点动延时。当点动命令未携带 info.delay 时，设备使用该默认值。

请求URL

https://wdev.wmj.com.cn/deviceApi/send

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_relay",
    "info": {
      "relay1": 1000
    }
  }
}

参数说明

参数名 必填 类型 取值范围 / 格式 默认值 说明
data.info.relay1 是 number 1000-30000，单位 ms 1000 默认点动延时

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "set_relay",
    "info": {
      "code": 0,
      "msg": "OK"
    }
  }
}

备注

  • 该设置当前为运行时生效，设备重启后恢复默认 1000ms。
  • 单次点动命令携带 info.delay 时，以本次 delay 为准。
6.语音提示文件

简要描述

W733 控制开门、停止、关门输出时会尝试播放固定文件名的本地语音缓存。

通道 文件名
开门 w733_open.mp3
停止 w733_stop.mp3
关门 w733_close.mp3

备注

  • 建议生产和平台侧统一使用以上固定文件名，避免因音频文件名不可知导致无法清理。
  • 固件会为每路保存文本标记；同一路文本相同时播放缓存音频，文本变化时合成并覆盖固定音频文件。
  • 若设备本地文件不存在，控制命令仍会执行，语音播放可能失败。
7.OTA升级1.0.10

简要描述

W733 1.0.10 包含控制语音 tts 参数，并兼容 W732 停止指令 pause / pause_lockup。OTA 使用 W733 产品目录下的 APP 小包。

请求URL

https://wdev.wmj.com.cn/deviceApi/send

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_ota",
    "info": {
      "hw_ver": "1.0.0",
      "sw_ver": "1.0.10",
      "url": "http://fm.wmj.com.cn/ota/W733/W733_1.0.10.bin"
    }
  }
}

参数说明

参数名 必填 类型 说明
data.cmd_type 是 string 固定传 set_ota
data.info.hw_ver 是 string 硬件版本，当前为 1.0.0
data.info.sw_ver 是 string 目标固件版本，当前为 1.0.10
data.info.url 是 string OTA 固件下载地址

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "set_ota",
    "info": {
      "code": 0,
      "msg": "OK"
    }
  }
}

备注

  • OTA 文件地址：http://fm.wmj.com.cn/ota/W733/W733_1.0.10.bin
  • OTA 文件大小：776292 bytes。
  • 升级前建议先调用 getdevinfo 确认设备在线、型号为 W733、当前版本低于 1.0.10。
8.解绑设备

请求URL

https://wdev.wmj.com.cn/deviceApi/logout

请求方式

POST

请求格式

json

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}"
}

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}"
  }
}
9.版本更新记录
日期 版本 内容
2026-07-07 1.0.10 兼容 W732 开关停卷帘门协议，停止点动支持 pause，锁定停止支持 pause_lockup，原 stop / stop_lockup 继续兼容；发布 1.0.10 OTA 地址并同步 Apipost 接口说明
2026-07-07 1.0.9 点动和锁定控制支持 tts 控制语音，三路固定语音缓存，同文本播报缓存音频，文本变化时合成覆盖固定缓存文件
2026-07-07 1.0.8 新增 W733 三路 4G 卷帘门控制器 API，包含状态查询、点动控制、锁定控制、默认延时和语音提示文件说明
作者：极客师傅  创建时间：2026-07-07 20:21
最后编辑：极客师傅  更新时间：2026-07-07 23:12
上一篇：
下一篇：