W72M 4G版空开断路器 API

本 API 适用于 W72M 4G 版空开断路器。设备通过硬件云 APIv2 接入，开发者使用 app_id、app_secret 和设备序列号完成注册、远程合闸、远程分闸、设备信息查询、定时动作、掉电记忆、状态上报和解绑。

app_id 和 app_secret 请登录 https://wdev.wmj.com.cn 获取。

点击下面的序号展开。

1.注册设备

简要描述

将 W72M 设备和应用绑定。注册成功后才能调用设备功能接口。

请求URL

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

请求方式

POST

请求格式

json

参数

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

参数说明

参数名	必选	类型	取值范围 / 格式	说明
app_id	是	string	平台分配	硬件云 app_id
app_secret	是	string	平台分配	硬件云 app_secret
device_sn	是	string	W72M 设备序列号	设备序列号

返回示例

{
  "code": 0,
  "msg": "注册成功"
}

2.公共请求结构

简要描述

除注册、解绑、在线状态查询外，功能接口统一调用发送指令接口，通过 data.cmd_type 区分具体功能。

请求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": "turnon",
    "info": {}
  }
}

参数名	必选	类型	取值范围 / 格式	说明
app_id	是	string	平台分配	硬件云 app_id
app_secret	是	string	平台分配	硬件云 app_secret
device_sn	是	string	W72M 设备序列号	设备序列号
type	否	int	固定传 `1`	请求类型
data.cmd_type	是	string	本文档列出的命令名	命令类型
data.info	否	object	JSON 对象	命令参数

通用返回

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "msg_id": 1,
    "type": 1,
    "cmd": "turnon",
    "cmd_type": "turnon",
    "info": {
      "code": 0,
      "msg": ""
    }
  }
}

参数名	类型	说明
code	int	平台接口调用错误码，0 表示平台已受理
data.info.code	int	设备业务错误码，0 表示成功
data.info.msg	string	设备返回消息

3.远程合闸

简要描述

控制空开合闸。

请求URL

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

请求方式

POST

参数

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

参数说明

参数名	必选	类型	取值范围 / 格式	默认值	说明
data.cmd_type	是	string	`turnon`	-	合闸命令

4.远程分闸

简要描述

控制空开分闸。

请求URL

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

请求方式

POST

参数

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

参数说明

参数名	必选	类型	取值范围 / 格式	默认值	说明
data.cmd_type	是	string	`turnoff`	-	分闸命令

5.查询设备信息

简要描述

查询设备版本、4G 网络状态、电气参数、保护阈值、掉电记忆和开关状态。

请求URL

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

请求方式

POST

参数

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

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "getdevinfo",
    "info": {
      "code": 0,
      "msg": "",
      "rssi": -62,
      "version": "72.1.04",
      "project": "W72M",
      "imei": "860000000000000",
      "iccid": "89860000000000000000",
      "total_electricity": 1.23,
      "switch_state": 1,
      "heartbeat": 1,
      "voltage": 220.3,
      "electric_current": 0.12,
      "power": 26.4,
      "temperature": 31,
      "retainstate": 1,
      "rsrp": -88,
      "rsrq": -10,
      "snr": 12,
      "csq": 22,
      "time": "2026-06-25 10:30:00"
    }
  }
}

返回字段说明

参数名	类型	说明
switch_state	int	当前开关状态，`1` 合闸，`0` 分闸
heartbeat	int	设备心跳状态
voltage	number	电压，单位 V
electric_current	number	电流，单位 A
power	number	功率，单位 W
total_electricity	number	累计电量，单位 kWh
temperature	number	温度
retainstate	int	掉电记忆，`1` 启用，`0` 禁用
overload	number	过载保护阈值；仅启用该保护项时返回
leakage_current	number	漏电流保护阈值；仅启用该保护项时返回
overheat	number	过热保护阈值；仅启用该保护项时返回
overcurrent	number	过流保护阈值；仅启用该保护项时返回
overvoltage	number	过压保护阈值；仅启用该保护项时返回
undervoltage	number	欠压保护阈值；仅启用该保护项时返回
rssi / rsrp / rsrq / snr / csq	number	4G 网络信号指标

6.设置定时动作

简要描述

设置按时间点执行的定时动作。W72M 使用 time 和 action 两个等长数组保存定时点，最多 10 组。

请求URL

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

请求方式

POST

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_timed_action",
    "info": {
      "time": [
        "08:00",
        "18:00"
      ],
      "action": [
        1,
        0
      ]
    }
  }
}

参数说明

参数名	必选	类型	取值范围 / 格式	默认值	说明
data.cmd_type	是	string	`set_timed_action`	-	设置定时动作
data.info.time	是	array	`HH:mm`，小时 `0-23`，分钟 `0-59`	-	执行时间数组
data.info.action	是	array	`1` / `0`	-	动作数组，`1` 合闸，`0` 分闸

清空定时动作

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_timed_action",
    "info": {
      "time": [],
      "action": []
    }
  }
}

7.设置掉电记忆

简要描述

设置设备重启或掉电恢复后是否保持上一次开关状态。

请求URL

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

请求方式

POST

参数

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

参数说明

参数名	必选	类型	取值范围 / 格式	默认值	说明
data.cmd_type	是	string	`set_retainstate`	-	设置掉电记忆
data.info.retainstate	是	int	`1` / `0`	-	`1` 启用，`0` 禁用

8.原始串口命令

简要描述

高级调试接口，用于下发十六进制串口命令并返回设备应答。仅建议在技术支持明确提供指令时使用。

请求URL

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

请求方式

POST

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "uart_cmd",
    "info": {
      "hex_cmd": "010300000001840A"
    }
  }
}

参数说明

参数名	必选	类型	取值范围 / 格式	默认值	说明
data.cmd_type	是	string	`uart_cmd`	-	原始串口命令
data.info.hex_cmd	是	string	十六进制字符串	-	串口下发数据

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "uart_cmd",
    "info": {
      "code": 0,
      "msg": "",
      "hex_ack": "0103020001B844"
    }
  }
}

9.重启设备

简要描述

远程重启设备。

请求URL

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

请求方式

POST

参数

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

10.在线状态查询

简要描述

查询设备是否在线。

请求URL

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

请求方式

POST

请求格式

json

参数

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

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "online": 1
  }
}

11.状态上报和回调

简要描述

设备上线、定时动作触发、每日电量统计、按键状态变化等事件会通过硬件云上报。开发者在平台配置回调地址后，可接收对应业务数据。

设备上线

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "dev_reg",
  "info": {
    "iccid": "89860000000000000000",
    "imei": "860000000000000",
    "rssi": -62,
    "sw_ver": "72.1.04",
    "hw_ver": "1.0.0",
    "username": "{{device_sn}}",
    "project": "W72M"
  }
}

定时动作触发

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "notify",
  "info": {
    "notify_type": "timed_action",
    "time": "08:00",
    "action": 1,
    "code": 0,
    "msg": ""
  }
}

电量统计上报

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "power_report",
  "info": {
    "device_sn": "{{device_sn}}",
    "total_electricity": 1.23,
    "switch_state": 1,
    "heartbeat": 1,
    "voltage": 220.3,
    "electric_current": 0.12,
    "power": 26.4,
    "temperature": 31,
    "retainstate": 1
  }
}

本地按键状态变化

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "turnon",
  "info": {
    "code": 0,
    "msg": ""
  }
}

12.解绑设备

简要描述

解除设备和应用绑定。解绑后该应用不能继续控制设备。

请求URL

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

请求方式

POST

请求格式

json

参数

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

参数说明

参数名	必选	类型	取值范围 / 格式	说明
app_id	是	string	平台分配	硬件云 app_id
app_secret	是	string	平台分配	硬件云 app_secret
device_sn	是	string	W72M 设备序列号	设备序列号

返回示例

{
  "code": 0,
  "msg": "解绑成功"
}

作者：极客师傅创建时间：2026-06-25 02:05
最后编辑：极客师傅更新时间：2026-06-25 02:05

上一篇： W71M WiFi版空开断路器 API
下一篇： W732(开关停卷帘门控制器)API