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

点击下面的序号展开
1.注册绑定设备

简要描述

将设备和appid、appsecret绑定

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567"
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号

返回示例

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

返回参数说明

参数名类型说明
codeint错误码，0成功其他异常
msgstring描述信息
备注

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

2.开门

简要描述

开门操作，适用于普通门禁模式

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "open",
        "info": {
            "sn": "W7671234567"
        }
    }
}
参数名必选类型说明
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.###否any可根据实际情况传入，会原值返回

返回示例

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

返回参数说明

参数名类型说明
codeint调用接口错误码，0成功其他异常
data.info.codeint业务错误码，0成功其他异常
data.info.msgstring业务错误信息
3.设置常开/常闭模式

简要描述

设置设备常开或常闭模式

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "set_nonc",
        "info": {
            "nonc_type": 0
        }
    }
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号
data.cmd_type是string命令标识set_nonc
data.info.nonc_type是int0=常闭，1=常开

返回示例

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

返回参数说明

参数名类型说明
codeint调用接口错误码，0成功其他异常
data.info.codeint业务错误码，0成功其他异常
data.info.msgstring业务错误信息
4.设置继电器触发时长

简要描述

设置继电器触发时长（毫秒）

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "set_relay",
        "info": {
            "relay1": 1500
        }
    }
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号
data.cmd_type是string命令标识set_relay
data.info.relay1是int继电器触发时长（毫秒），默认1500

返回示例

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

返回参数说明

参数名类型说明
codeint调用接口错误码，0成功其他异常
data.info.codeint业务错误码，0成功其他异常
data.info.msgstring业务错误信息
5.设置蜂鸣器开关

简要描述

全局启用或禁用蜂鸣器

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "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是int0=禁用蜂鸣器，1=启用蜂鸣器

返回示例

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

返回参数说明

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

备注

禁用蜂鸣器后，所有需要蜂鸣器提示的操作将静音执行

6.远程配置WiFi

简要描述

远程配置设备WiFi连接信息

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "set_wifi",
        "info": {
            "ssid": "WiFi_Name",
            "passwd": "WiFi_Password"
        }
    }
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号
data.cmd_type是string命令标识set_wifi
data.info.ssid是stringWiFi名称
data.info.password否stringWiFi密码（开放WiFi可不传）

返回示例

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

返回参数说明

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

备注

配置成功后设备将自动重启并连接新WiFi

7.修改密码

简要描述

修改设备Web端管理密码和开门密码

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "set_pwd",
        "info": {
            "device_pwd": "12345678",
            "admin_pwd": "admin123"
        }
    }
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号
data.cmd_type是string命令标识set_pwd
data.info.device_pwd否string设备Web端应急开门密码
data.info.admin_pwd否string设备Web端配网管理密码

返回示例

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

返回参数说明

参数名类型说明
codeint调用接口错误码，0成功其他异常
data.info.codeint业务错误码，0成功其他异常
data.info.msgstring业务错误信息
8.获取设备信息

简要描述

获取设备当前配置信息

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "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": {
            "sn": "W7671234567",
            "sw_ver": "67.0.06",
            "hw_ver": "1.0",
            "device_pwd": "12345687",
            "admin_pwd": "admin",
            "sta_ssid": "WiFi_Name",
            "sta_pwd": "WiFi_Password",
            "project": "W767",
            "net_type": "wifi",
            "iccid": "WiFi_Name",
            "imei": "AA:BB:CC:DD:EE:FF",
            "nonc": 0,
            "rssi": -45,
            "doorstate": 0,
            "relay1": 1500,
            "device_sound": 1,
            "code": 0,
            "msg": "OK"
        }
    }
}

返回参数说明

参数名类型说明
codeint调用接口错误码，0成功其他异常
data.info.snstring设备序列号
data.info.sw_verstring软件版本号
data.info.hw_verstring硬件版本号
data.info.device_pwdstring设备开门密码
data.info.admin_pwdstringWeb管理密码
data.info.sta_ssidstringWiFi名称
data.info.sta_pwdstringWiFi密码
data.info.projectstring项目型号
data.info.net_typestring网络类型（wifi）
data.info.iccidstringSIM卡ICCID（WiFi模式下与sta_ssid相同）
data.info.imeistring设备MAC地址
data.info.noncint常开常闭模式（0=常闭，1=常开）
data.info.rssiintWiFi信号强度（dBm）
data.info.doorstateint门状态（0=关闭，1=打开）
data.info.relay1int继电器触发时长（毫秒）
data.info.device_soundint蜂鸣器开关（0=禁用，1=启用）
data.info.codeint业务错误码，0成功其他异常
data.info.msgstring业务错误信息
9.获取门状态

简要描述

获取门当前开关状态

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "getdoorstate",
        "info": {}
    }
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号
data.cmd_type是string命令标识getdoorstate

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "getdoorstate",
        "info": {
            "door_state": 0,
            "code": 0,
            "msg": "OK"
        }
    }
}

返回参数说明

参数名类型说明
codeint调用接口错误码，0成功其他异常
data.info.door_stateint门状态（0=关闭，1=打开）
data.info.codeint业务错误码，0成功其他异常
data.info.msgstring业务错误信息
10.重启设备

简要描述

远程重启设备

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "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": "OK"
        }
    }
}

返回参数说明

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

备注

设备收到命令后将在3秒内重启

11.OTA固件升级

简要描述

远程升级设备固件

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567",
    "data": {
        "cmd_type": "set_ota",
        "info": {
            "url": "http://example.com/firmware.bin",
            "version": "67.0.07"
        }
    }
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号
data.cmd_type是string命令标识set_ota
data.info.url是string固件下载URL地址（HTTP/HTTPS）
data.info.version否string固件版本号

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "set_ota",
        "info": {
            "code": 0,
            "msg": "开始升级"
        }
    }
}

返回参数说明

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

备注

  • 升级过程中设备将自动重启

  • 请确保固件URL可访问且固件文件正确

  • 建议使用HTTPS链接确保固件安全

12.删除解绑

简要描述

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567"
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号

返回示例

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

返回参数说明

参数名类型说明
codeint错误码，0成功其他异常
msgstring描述信息
13.蓝牙开门接口

(1) 获取临时密码

通过云端API获取蓝牙开门所需的临时密码

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "device_sn": "W7671234567"
}
参数名必选类型说明
app_id是string用户app_id
app_secret是string用户app_secret
device_sn是string设备序列号

返回示例

{
    "code": 0,
    "data": {
        "pwd": "03057414",
        "roll_code": 26
    }
}

返回参数说明

参数名类型说明
codeint错误码，0成功其他异常
data.pwdstring临时开门密码（用于蓝牙开门）
data.roll_codeint当前滚动码值（0-999循环）

备注

  • 临时密码一次性有效，开门成功后自动失效

  • 后获取的密码开门成功后，之前获取的密码将失效

  • 开门记录会回调到配置的回调URL

(2) 蓝牙开门操作

使用获取到的临时密码通过蓝牙开门

服务UUID

  • 开锁服务: FEE0

  • 写特性: FEE1 (接收开门命令)

  • 通知特性: FEE2 (返回执行结果)

请求格式

通过蓝牙向特性 FEE1 写入JSON格式数据：

{
    "cmd_type": "ble_pwd_open_lock",
    "info": {
        "data": "03057414"
    }
}
参数名必选类型说明
cmd_type是string命令类型，固定为ble_pwd_open_lock
info.data是string临时密码（从云端API获取的pwd字段）

返回格式

设备通过特性 FEE2 的通知返回结果：

{
    "state": 1,
    "info": {
        "code": 0,
        "msg": "Unlock success"
    }
}
参数名类型说明
stateint开门状态（0=失败，1=成功）
info.codeint业务错误码（0=成功，-1=失败）
info.msgstring执行结果描述

 

安全机制：

  • 滚动码机制确保每次密码唯一

  • 密码使用后滚动码自动递增

  • 后获取的密码会使前面未使用的密码失效

设备硬件规格

  • WiFi: 2.4GHz IEEE 802.11 b/g/n

  • 蓝牙: BLE 5.0

  • 继电器: 1路控制

  • 门磁检测: 实时监测门状态

  • 蜂鸣器: 提示音

固件版本

当前固件版本: 67.0.06

技术支持

如有问题请访问: wdev.wmj.com.cn

作者：极客师傅  创建时间：2025-03-18 23:40
最后编辑：极客师傅  更新时间：2025-11-16 00:56
上一篇：
下一篇：