W767(WiFi+蓝牙门禁控制器)API

简要描述

将设备和appid、appsecret绑定

请求URL

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

请求方式

POST

请求格式

json

请求参数

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

返回示例

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

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

返回参数说明

备注

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

简要描述

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "open",
        "info": {
            "sn": "W7671234567",
            "cmd_id": "order_20260127_001",
            "user_id": "user123"
        }
    }
}

返回示例

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

返回参数说明

简要描述

设置设备常开或常闭模式

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_nonc",
        "info": {
            "type": 0
        }
    }
}

返回示例

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

返回参数说明

简要描述

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_relay",
        "info": {
            "relay1": 1500
        }
    }
}

返回示例

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

返回参数说明

简要描述

全局启用或禁用蜂鸣器

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_device_sound",
        "info": {
            "device_sound": 1
        }
    }
}

返回示例

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

返回参数说明

备注

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

简要描述

远程配置设备WiFi连接信息

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_wifi",
        "info": {
            "ssid": "WiFi_Name",
            "passwd": "WiFi_Password"
        }
    }
}

返回示例

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

返回参数说明

备注

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

简要描述

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_pwd",
        "info": {
            "device_pwd": "12345678",
            "admin_pwd": "admin123"
        }
    }
}

返回示例

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

返回参数说明

简要描述

获取设备当前配置信息

请求URL

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

请求方式

POST

请求格式

json

请求参数

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

返回示例

{
    "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"
        }
    }
}

返回参数说明

简要描述

获取门当前开关状态

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "getdoorstate",
        "info": {}
    }
}

返回示例

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

返回参数说明

ℹ️ 版本要求：固件版本 v67.0.09 及以上

简要描述

配置开门成功后的HTTP回调地址，设备开门成功后会自动向该地址POST通知

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_callback",
        "info": {
            "enabled": 1,
            "url": "https://your-server.com/door_callback"
        }
    }
}

返回示例

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

返回参数说明

备注

• 回调地址需保证可访问，设备会自动重试直到成功
• 最多保存100条未成功的回调记录，设备重启后继续重试
• 推荐使用HTTPS地址

查询回调配置

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "get_callback",
        "info": {}
    }
}

返回示例

{
    "code": 0,
    "data": {
        "cmd_type": "get_callback",
        "info": {
            "enabled": 1,
            "url": "https://your-server.com/door_callback",
            "pending_count": 0,
            "success_total": 15,
            "fail_total": 0,
            "code": 0,
            "msg": "OK"
        }
    }
}

ℹ️ 版本要求：固件版本 v67.0.09 及以上

简要描述

设备开门成功后，自动向配置的回调地址POST通知

请求URL

由业务方配置的回调地址（通过set_callback设置）

请求方式

POST

请求格式

json

回调内容

{
    "device_sn": "{{device_sn}}",
    "msg_id": 124,
    "event": "door_opened",
    "open_type": "mqtt",
    "timestamp": 1706345678,
    "rssi": -56,
    "cmd_id": "order_20260127_001",
    "user_id": "user123",
    "extra": {
        "delaytime": 1000
    },
    "callback_id": 4
}

业务方响应要求

业务方接收到回调后，需返回HTTP状态码 200，设备才认为回调成功。

开门时传递业务参数

在开门接口中传入cmd_id和user_id，回调时会原样返回：

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "open",
        "info": {
            "cmd_id": "order_20260127_001",
            "user_id": "user123"
        }
    }
}

备注

• 回调失败会自动重试，最多保存100条待回调记录
• 设备重启后会继续重试未成功的回调
• 建议业务方通过cmd_id做幂等处理，避免重复处理

简要描述

远程重启设备

请求URL

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

请求方式

POST

请求格式

json

请求参数

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

返回示例

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

返回参数说明

备注

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

简要描述

远程升级设备固件

请求URL

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

请求方式

POST

请求格式

json

请求参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "{{device_sn}}",
    "data": {
        "cmd_type": "set_ota",
        "info": {
            "url": "http://fm.wmj.com.cn/ota/W767/W767_67.0.09.bin",
            "hw_ver": "1.0.0",
            "sw_ver": "67.0.09"
        }
    }
}

返回示例

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

返回参数说明

备注

• 升级过程中设备将自动重启
• 请确保固件URL可访问且固件文件正确
• 建议使用HTTPS链接确保固件安全

简要描述

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

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

返回示例

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

返回参数说明

(1) 获取临时密码

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

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

返回示例

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

返回参数说明

备注

• 临时密码一次性有效，开门成功后自动失效
• 后获取的密码开门成功后，之前获取的密码将失效
• 开门记录会回调到配置的回调URL

(2) 蓝牙开门操作

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

服务UUID

• 开锁服务: FEE0
• 写特性: FEE1 (接收开门命令)
• 通知特性: FEE2 (返回执行结果)

请求格式

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

{
    "cmd_type": "ble_pwd_open_lock",
    "info": {
        "data": "03057414"
    }
}

返回格式

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

{
    "state": 1,
    "info": {
        "code": 0,
        "msg": "Unlock success"
    }
}

(3) 自行开发小程序的接入顺序

蓝牙开门与配网、硬件配置使用不同的服务和特征值。不要选择发现列表中的第一个可写特征，也不要复用配网流程中的服务及特征值。

完整 UUID 分别为：

• 服务：0000FEE0-0000-1000-8000-00805F9B34FB
• 写特征：0000FEE1-0000-1000-8000-00805F9B34FB
• 通知特征：0000FEE2-0000-1000-8000-00805F9B34FB

1. 连接目标设备后发现服务及特征，按 UUID 精确匹配；比较时统一大小写及短 UUID/完整 UUID 表示方式，不依赖数组下标。
2. 先注册通知接收回调，再订阅 FEE0/FEE2；等待订阅成功后才发送开门请求。
3. 由业务后端鉴权后调用上述临时密码接口，获取当前目标设备的 data.pwd。开发者 app_secret 只保存在后端，不内置到小程序，也不通过蓝牙发送。
4. 将上述 ble_pwd_open_lock JSON 编码为 UTF-8，写入 FEE0/FEE1。info.data 必须是字符串，使用接口实际返回的密码并保留前导零；示例密码不能直接用于真实设备。
5. 蓝牙报文直接以 cmd_type、info 为顶层字段，不要套用云端命令的 app_id、device_sn、外层 data 等包装。
6. 仅处理目标设备、目标服务及 FEE2 的结果通知；以 state=1 且 info.code=0 判断设备接受并执行成功。写入 API 成功只代表写入完成，不代表门已打开；物理门状态应另行核验。

报文长度：当前 IDF 固件要求每次写入包含完整 JSON，没有应用层分片拼接。普通 ATT 写入容量受协商 MTU 限制（通常为 MTU 减 3 字节）。发送前确认实际写入容量足以容纳完整 UTF-8 报文；不要把 JSON 拆成多次独立写入。若平台无法提供足够容量，应报告不支持并排查兼容性，不要循环发送残缺报文。

(4) 蓝牙错误排查

以下错误文案适用于返回这些文案的 W767 IDF 固件；旧固件返回内容可能不同。

{"info":{"code":-1,"msg":"Hardware config rejected"},"state":0}

Hardware config rejected 表示硬件配置请求被拒绝，不等同于开门临时密码错误。普通开门流程出现此结果时，优先检查是否误写 0D38/33FF，或把硬件配置通知错误地当作开门通知。

处理方式是修正服务、写特征及通知特征，不是补填硬件配置密钥。普通蓝牙开门不需要提交硬件配置参数。

若仍不能接入，请提供固件版本、手机系统与机型、实际服务/写特征/通知特征 UUID、发送字节长度及脱敏 JSON。不要提交真实临时密码、开发者密钥或硬件配置密钥。

安全机制： - 滚动码机制确保每次密码唯一 - 密码使用后滚动码自动递增 - 成功使用后获取的密码后，之前的密码可能无法继续使用；每次开门请重新获取临时密码，不缓存复用

+++

设备硬件规格

• WiFi: 2.4GHz IEEE 802.11 b/g/n
• 蓝牙: BLE 5.0
• 继电器: 1路控制
• 门磁检测: 实时监测门状态
• 蜂鸣器: 提示音

固件版本

当前固件版本: 67.0.09

技术支持

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