W763（三路门禁控制器）API

概述

W763 是带 Wi-Fi 和网线联网能力的三路门禁控制器，设备序列号前缀为 W763。从固件 63.1.67 起，三路继电器可分别设置为脉冲或锁止模式，并支持兼容旧版出门按钮接线。

通道 常用命令 锁止命令 模式字段 延时字段
继电器 1 open open_lockup relay1_mode relay1，兼容 relay
继电器 2 close；workmode=2 时也用于 open close_lockup relay2_mode relay2
继电器 3 pause，兼容 stop pause_lockup，兼容 stop_lockup relay3_mode relay3

继电器模式值：0 为脉冲，动作后按设置时间自动释放；1 为锁止，使用 enable=1 吸合、enable=0 释放。三路互相独立，新动作会取消同一路尚未结束的脉冲。

所有云端设备命令使用以下公共地址和外层结构：

  • 请求 URL：https://wdev.wmj.com.cn/deviceApi/send
  • 请求方式：POST
  • Content-Type：application/json
1.注册设备

请求URL

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

请求方式

POST

参数

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

返回示例

{
  "code": 0,
  "msg": "注册成功"
}
2.三路继电器控制

简要描述

open、close、pause 分别控制业务对应的继电器，并按照该路持久化配置的脉冲或锁止模式执行。stop 是 pause 的兼容别名。

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "open",
    "info": {
      "delay": 1500,
      "enable": 1
    }
  }
}
参数名 必选 类型 取值范围 说明
data.cmd_type 是 string open / close / pause / stop 选择业务动作
data.info.delay 否 number 100-60000 ms 仅本次脉冲的时间；不传时使用该路默认值
data.info.enable 否 number 1 / 0 锁止模式下控制吸合或释放，默认 1

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd": "open",
    "info": {
      "code": 0,
      "err_code": 0,
      "msg": ""
    }
  }
}

备注

  • workmode=0 或 1 时，open 控制继电器 1；workmode=2 时控制继电器 2。
  • close 控制继电器 2，pause / stop 控制继电器 3。
  • nonc_type=1 保留旧版常开行为，普通控制命令仅鸣响蜂鸣器，不改变继电器。
3.明确锁止控制

简要描述

不依赖该路默认模式，直接吸合或释放指定继电器。适用于需要明确保持状态的业务。

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "open_lockup",
    "info": {
      "enable": 1
    }
  }
}
参数名 必选 类型 取值范围 说明
data.cmd_type 是 string open_lockup / close_lockup / pause_lockup / stop_lockup 分别对应继电器 1、2、3
data.info.enable 是 number 1 / 0 1 吸合保持，0 释放

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd": "open_lockup",
    "info": {
      "relay": 1,
      "enable": 1,
      "code": 0,
      "err_code": 0,
      "msg": ""
    }
  }
}
4.设置三路继电器模式和延时

简要描述

设置三路继电器的持久化工作模式和默认脉冲时间。未提供的字段保持当前值。

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_relay",
    "info": {
      "relay1": 1500,
      "relay2": 10000,
      "relay3": 1000,
      "relay1_mode": 0,
      "relay2_mode": 1,
      "relay3_mode": 0
    }
  }
}
参数名 必选 类型 取值范围 说明
relay1 / relay2 / relay3 否 number 100-60000 ms 各路默认脉冲时间
relay 否 number 100-60000 ms relay1 的旧版兼容字段
relay1_mode / relay2_mode / relay3_mode 否 number 0 / 1 0 脉冲，1 锁止

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd": "set_relay",
    "info": {
      "relay": 1500,
      "relay1": 1500,
      "relay2": 10000,
      "relay3": 1000,
      "relay1_mode": 0,
      "relay2_mode": 1,
      "relay3_mode": 0,
      "code": 0,
      "err_code": 0,
      "msg": ""
    }
  }
}
5.设置出门按钮接线模式

简要描述

选择出门按钮对应的硬件接线方式。

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_exit_mode",
    "info": {
      "exit_mode": 0
    }
  }
}
exit_mode 接线方式 按钮动作
0 旧版磁力锁直控 同时控制继电器 1 和继电器 2
1 门禁电源开关量输入 按 workmode 选择继电器 1 或继电器 2

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd": "set_exit_mode",
    "info": {
      "exit_mode": 0,
      "code": 0,
      "err_code": 0,
      "msg": ""
    }
  }
}

备注

  • 从旧版固件升级时，设备会根据保留配置自动选择接线方式。
  • es_status=0 时禁用出门按钮输出，仅上报 esrod 事件。
  • nonc_type=1 时，出门按钮只触发蜂鸣器，不改变继电器。
6.设置工作模式、出门按钮和常开常闭

工作模式

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

workmode：0 普通模式，1 卷帘门模式，2 自控模式。

出门按钮启用状态

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

status：1 启用，0 禁用。

常开常闭

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

type：0 常闭业务状态，1 常开业务状态。切换后设备会把三路输出恢复到对应的空闲电平。

7.查询设备和继电器状态

参数

{
  "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": "getdevinfo",
    "info": {
      "sw_ver": "63.1.67",
      "hw_ver": "1.0.0",
      "project": "W763_WiFi",
      "net_type": "WiFi",
      "nonc": 0,
      "es_status": 1,
      "workmode": 1,
      "exit_mode": 0,
      "relay": 1500,
      "relay1": 1500,
      "relay2": 10000,
      "relay3": 1000,
      "relay1_mode": 0,
      "relay2_mode": 1,
      "relay3_mode": 0,
      "relay1_state": 0,
      "relay2_state": 1,
      "relay3_state": 0,
      "door_state": 1,
      "code": 0,
      "err_code": 0,
      "msg": ""
    }
  }
}
字段 说明
relay1_state / relay2_state / relay3_state 各路逻辑状态，1 为吸合，0 为释放
relay1_mode / relay2_mode / relay3_mode 各路工作模式，0 脉冲，1 锁止
net_type 当前上云网络，WiFi 或 ETH
8.门状态和出门按钮事件

设备按硬件云配置的回调地址上报事件。

{
  "device_sn": "{{device_sn}}",
  "msg_id": 0,
  "type": 2,
  "cmd": "exitopened",
  "cmd_type": "exitopened",
  "info": {}
}
事件 触发条件
dooropen 门状态变为打开
doorclose 门状态变为关闭
exitopened 已启用的出门按钮被按下
exit_switch 出门按钮动作兼容事件
esrod 禁用状态下检测到出门按钮动作
9.OTA 升级 63.1.67

参数

{
  "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": "63.1.67",
      "url": "http://fm.wmj.com.cn/ota/W763/W763_WiFi_63.1.67.bin"
    }
  }
}

备注

  • 远程升级只使用 OTA 应用镜像，不使用 4 MB 量产完整镜像。
  • 命令返回升级任务已启动，仅表示设备已受理。设备重启并重新上线后，必须通过 getdevinfo 确认 sw_ver=63.1.67。
  • 本版本保持 ESP32-C3 最低芯片版本 v0.3，Flash 为 40 MHz、DIO 模式。
10.解绑设备

请求URL

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

请求方式

POST

参数

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

返回示例

{
  "code": 0,
  "msg": "解绑成功"
}
11.版本更新记录
日期 版本 内容
2026-09-17 63.1.67 三路继电器可独立设置脉冲或锁止模式；增加明确锁止命令、继电器状态字段和出门按钮接线兼容配置；保留旧版继电器延时字段和 63.1.52 接线行为
2026-09-17 63.1.66 完善设备启动注册和版本、网络身份上报
作者：极客师傅  创建时间：2025-03-18 23:32
最后编辑：极客师傅  更新时间：2026-09-17 14:59
上一篇：
下一篇：