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

返回参数说明

统一开门回调协议

适用 W767 67.1.22、W76M 76.0.8，硬件1.0.0。使用前通过 getdevinfo 确认型号和版本；旧版本不能只按版本数值推断支持全部回调。

配置及回读

POST https://wdev.wmj.com.cn/deviceApi/send，Content-Type: application/json。

{"app_id":"{{wmjv2appid}}","app_secret":"{{wmjv2appsecret}}","device_sn":"{{device_sn}}","type":1,"data":{"cmd_type":"set_callback","info":{"url":"https://example.com/callback","enabled":1}}}

url 为 HTTP(S) 地址，最多255字节；enabled 必须为数值0或1。兼容 callback_url/callback_enabled 别名；同时提交两套字段时值必须一致。省略字段保留原值。空参数、错误类型、冲突值、启用但URL为空均返回设备 data.info.code 非零。平台 code=0 不等于设备配置或投递成功。

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

回读设备 data.info 示例：

{"code":0,"err_code":0,"msg":"","callback_ready":true,"callback_url":"https://example.com/callback","callback_enabled":1,"pending_callbacks":0,"callback_capacity":4,"callback_success":1,"callback_failed":0,"callback_dropped":0,"callback_storage_errors":0,"callback_last_http":200,"callback_last_error":0}

ready 表示回调功能初始化状态；pending/capacity 为待发数和容量。success/failed/dropped/storage_errors 为本次启动计数，不是终身计数。last_http 为最近HTTP状态；last_error 为传输错误码，0表示无传输错误，仍须检查HTTP状态。

POST 通知格式

设备向配置的URL发送 HTTP POST，Content-Type: application/json，不包裹 data/info：

{"device_sn":"{{device_sn}}","event":"door_opened","open_type":"api","event_uid":"example-device-8ce5dafcc085d6d8","callback_id":627159385,"msg_id":206,"timestamp":23,"rssi":-40,"cmd_id":"order-001","user_id":"user-001"}

api 为API触发开门；ble 为蓝牙鉴权后开门；button 为控制器可感知的开门按钮；web 为本地应急网页；schedule 为定时计划；delay 为延时到期。蓝牙/按钮等不带 cmd_id/user_id，其他自定义字段不透传。关闭或释放继电器不产生door_opened。

W76M 开门按钮支持button；W767板载按键用于配网/复位，不因此变成开门按钮。外接按钮若绕过控制器直接接门禁电源，固件无法感知其操作。

投递、离线及错误处理

• 接收端返回 HTTP200/201/204 表示成功，正文不限；其他状态和网络失败重试。不跟随重定向。
• 重试间隔10/20/40/80/160/300秒，之后上限300秒；必须按event_uid幂等，不能假设只到达一次或严格按发生顺序到达。
• 最多4条持久化待发记录；断网期间启用状态下的开门记录入队，联网后补发。满队列不会覆盖旧记录，新记录可能丢弃，应监测callback_dropped/storage_errors；不保证无限离线事件留存。
• API open应答中的callback_queued/callback_error独立于开门结果。队列失败不撤销开门动作；禁用时不入队。仅ACK成功不能证明业务服务器收到通知。
• 禁用暂停旧队列；重新启用后按事件原URL补发，已在途请求可能完成。恢复出厂清除回调配置与队列。升级前产生的旧事件保留原内容，可能仍含旧值mqtt。
• 建议使用HTTPS并校验业务关联。本载荷没有应用级签名，不应仅凭此通知授予新的开门权限。

验证范围：两款均已验证API开门、延时回调及失败重启补发；W76M另有按钮实测。蓝牙、网页、定时计划的回调入口已接入，但本轮尚未完成对应现场触发验证；HTTPS、满队列与长时间离线需按业务环境验证。

简要描述

远程重启设备

请求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秒内重启

适用W767硬件1.0.0，目标版本67.1.22。POST https://wdev.wmj.com.cn/deviceApi/send，Content-Type: application/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": "67.1.22",
      "url": "http://fm.wmj.com.cn/ota/W767/W767_v67.1.22_ota.bin"
    }
  }
}

目标版本必须高于当前版本。ACK仅表示升级受理；重启上线后通过getdevinfo回读版本并验证业务。

(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。不要提交真实临时密码、开发者密钥或硬件配置密钥。

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

简要描述

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

请求URL

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

请求方式

POST

请求格式

json

请求参数

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

返回示例

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

返回参数说明

+++

设备硬件规格

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

固件版本

本文原版接口基线：67.0.09，不是全部设备的当前版本。实际版本以 getdevinfo.sw_ver 为准；回调能力请查看页面顶部的适用范围提示。

技术支持

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