W761(WiFi版门禁控制器)API

W761 设备 API 接口文档

本api适用于序列号开头为W761的设备，app_id和app_secret请到wdev.wmj.com.cn 填写手机号或邮箱登录获取。

点击下面的序号展开

1. 注册绑定设备

简要描述

将设备和app_id、app_secret绑定

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678"
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号

返回示例

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

{
    "code": 1005,
    "msg": "设备已注册"
}

返回参数说明

参数名	类型	说明
code	int	错误码 0成功其他异常
msg	string	描述

备注

更多返回错误代码请看首页的错误代码描述

2. 开门

简要描述

远程开门/卷帘门上升

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "open",
        "info": {
            "sn":"W7612345678",
            "delay": 3000
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	开锁标识`open`
data.info.sn	否	string	一旦传入sn，设备将校验传入sn是否与设备本身sn一致，校验成功才能开门
data.info.delay	否	int	继电器触发时长(毫秒)，不传则使用设备默认配置

返回示例

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

{
    "code": 1001,
    "msg": "网络超时"
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息

3. 设置常开/常闭模式

简要描述

设置继电器为常开或常闭模式

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "set_nonc",
        "info": {
            "type": 1
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`set_nonc`
data.info.type	是	int	0=常闭(默认)，1=常开

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "set_nonc",
        "info": {
            "code": 0,
            "msg": ""
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息

4. 设置继电器触发时长

简要描述

设置继电器默认触发时长

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "set_relay",
        "info": {
            "relay1": 2000
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`set_relay`
data.info.relay1	是	int	继电器触发时长(毫秒)，建议范围100-10000

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "set_relay",
        "info": {
            "code": 0,
            "msg": "",
            "relay1": 2000
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息
data.info.relay1	int	设置后的继电器时长

5. 设置蜂鸣器开关

简要描述

启用或禁用设备蜂鸣器提示音

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "set_device_sound",
        "info": {
            "device_sound": 1
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`set_device_sound`
data.info.device_sound	是	int	0=禁用蜂鸣器，1=启用蜂鸣器

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "set_device_sound",
        "info": {
            "code": 0,
            "msg": "",
            "device_sound": 1
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息
data.info.device_sound	int	设置后的蜂鸣器状态

6. 远程配置WiFi

简要描述

远程修改设备WiFi配置

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "set_wifi",
        "info": {
            "ssid": "MyWiFi",
            "passwd": "12345678"
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`set_wifi`
data.info.ssid	是	string	WiFi SSID
data.info.passwd	是	string	WiFi密码(至少8位)

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "set_wifi",
        "info": {
            "code": 0,
            "msg": "WiFi config updated, device will restart",
            "ssid": "MyWiFi",
            "passwd": "12345678"
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息
data.info.ssid	string	设置后的WiFi SSID
data.info.passwd	string	设置后的WiFi密码

备注

设置成功后设备会在3秒后自动重启以应用新配置
重启后设备会尝试连接新的WiFi

7. 修改设备密码

简要描述

修改设备应急开门密码和管理密码

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "set_pwd",
        "info": {
            "device_pwd": "87654321",
            "admin_pwd": "newadmin"
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`set_pwd`
data.info.device_pwd	否	string	应急开门密码(至少4位)
data.info.admin_pwd	否	string	管理密码(至少4位)

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "set_pwd",
        "info": {
            "code": 0,
            "msg": "Password updated",
            "device_pwd": "updated",
            "admin_pwd": "updated"
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息
data.info.device_pwd	string	应急开门密码更新状态
data.info.admin_pwd	string	管理密码更新状态

8. 获取设备信息

简要描述

获取设备详细信息和状态

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "getdevinfo",
        "info": {}
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`getdevinfo`

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "getdevinfo",
        "info": {
            "code": 0,
            "msg": "",
            "sw_ver": "1.0.0",
            "hw_ver": "1.0",
            "project": "W761",
            "net_type": "Wi-Fi",
            "ssid": "MyWiFi",
            "passwd": "12345678",
            "mac": "AA:BB:CC:DD:EE:FF",
            "nonc": 0,
            "device_sound": 1,
            "relay1": 1000,
            "rssi": -45,
            "bssid": "AA:BB:CC:DD:EE:FF",
            "device_pwd": "12345687",
            "admin_pwd": "admin",
            "free_heap": 21408
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息
data.info.sw_ver	string	软件版本
data.info.hw_ver	string	硬件版本
data.info.project	string	项目名称
data.info.net_type	string	网络类型(Wi-Fi/Ethernet)
data.info.ssid	string	WiFi SSID
data.info.passwd	string	WiFi密码
data.info.mac	string	MAC地址
data.info.nonc	int	常开/常闭模式(0=常闭,1=常开)
data.info.device_sound	int	蜂鸣器状态(0=禁用,1=启用)
data.info.relay1	int	继电器触发时长(毫秒)
data.info.rssi	int	WiFi信号强度(dBm)
data.info.bssid	string	WiFi BSSID
data.info.device_pwd	string	应急开门密码
data.info.admin_pwd	string	管理密码
data.info.free_heap	int	可用内存(字节)

9. 综合设置

简要描述

用来批量设置设备参数(密码、WiFi、继电器时长、蜂鸣器等)

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "dev_setting",
        "info": {
            "device_pwd": "12345678",
            "admin_pwd": "Admin",
            "sta_ssid": "MyWiFi",
            "sta_pwd": "wifipassword",
            "nonc": 0,
            "relay": 1000,
            "buzzer": 1
        }
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	设置命令`dev_setting`
data.info.device_pwd	否	string	设备web端开门密码
data.info.admin_pwd	否	string	设备web端管理密码
data.info.sta_ssid	否	string	WiFi SSID
data.info.sta_pwd	否	string	WiFi密码
data.info.nonc	否	int	常开/常闭模式(0=常闭,1=常开)
data.info.relay	否	int	继电器触发时长(毫秒)
data.info.buzzer	否	int	蜂鸣器开关(0=禁用,1=启用)

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "dev_setting",
        "info": {
            "code": 0,
            "msg": ""
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息

10. 查询在线状态

简要描述

查询设备是否联网在线

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678"
}

参数名	必选	类型	说明
app_id	是	string	硬件云app_id
app_secret	是	string	硬件云app_secret
device_sn	是	string	设备序列号

返回示例

{
    "code": 0,
    "data": {
        "on_line": 1
    },
    "msg": "查询成功"
}

返回参数说明

参数名	类型	说明
code	int	错误码 0成功其他异常
data.on_line	int	0=离线，1=在线
msg	string	描述

11. 重启设备

简要描述

远程重启设备

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678",
    "data": {
        "cmd_type": "restart",
        "info": {}
    }
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号
data.cmd_type	是	string	命令标识`restart`

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "restart",
        "info": {
            "code": 0,
            "msg": ""
        }
    }
}

返回参数说明

参数名	类型	说明
code	int	调用接口错误码 0成功其他异常
data.info.code	int	业务错误码，0成功其他异常
data.info.msg	string	业务错误信息

备注

设备会在3秒后自动重启

12. 删除解绑

简要描述

删除解绑，将设备从当前app_id解绑

请求URL

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

请求方式

POST

请求格式

json

参数

{
    "app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7612345678"
}

参数名	必选	类型	说明
app_id	是	string	用户app_id
app_secret	是	string	用户app_secret
device_sn	是	string	设备序列号

返回示例

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

返回参数说明

参数名	类型	说明
code	int	错误码 0成功其他异常
msg	string	描述

错误码说明

错误码	说明
0	成功
1001	网络超时
1005	设备已注册
其他	请联系技术支持

作者：极客师傅创建时间：2025-03-18 23:29
最后编辑：极客师傅更新时间：2025-11-16 01:58

上一篇： W732(开关停卷帘门控制器)API
下一篇： W762(网线版门禁控制器)API