本api适用于序列号开头为W761的设备,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": "W7612345678"
}
参数名必选类型说明
app_idstring用户app_id
app_secretstring用户app_secret
device_snstring设备序列号
返回示例
{
	"code": 0,
	"msg": "注册成功"
}
{
	"code": 1005,
	"msg": "设备已注册"
}
返回参数说明
参数名类型说明
codeint错误码 0成功其他异常
msgint描述
备注
  • 更多返回错误代码请看首页的错误代码描述

 

2.开门

简要描述
  • 开门

请求URL
  • https://wdev.wmj.com.cn/deviceApi/send

请求方式
  • POST

请求格式
  • json

参数

 

{
	"app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"device_sn": "设备序列号",
	"data": {
		"cmd_type": "open",
		"info": {
			"sn":"W7612345678"
		}
	}
}
参数名必选类型说明
app_idstring用户app_id
app_secretstring用户app_secret
device_snstring设备序列号
data.cmd_typestring开锁标识cmd_type
data.info.snstring一旦传入sn,设备将校验传入sn是否与设备本身sn一致,校验成功才能开门
data.info.###any可根据实际情况传入,会原值返回
返回示例
//成功
{
	"code": 0,
	"data": {
		"cmd_type": "open",
		"info": {
			"code": 0,
			"msg": ""
		}
	}
}
//失败
{
	"code": 1001,
	"msg": "网络超时"
}
返回参数说明
参数名类型说明
codeint调用接口错误码 0成功其他异常
data.info.codeint业务错误码,0成功其他异常
data.info.msgstring业务错误信息

3.设置

简要描述
  • 用来设置管理密码和应急开门密码

请求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"
		}
	}
}
参数名必选类型说明
app_idstring用户app_id
app_secretstring用户app_secret
device_snstring设备序列号
data.cmd_typestring设置命令dev_setting
data.info.device_pwdstring设备web端开门密码
data.info.admin_pwdstring设备web端管理密码
返回示例
//成功
{
	"code": 0,
	"data": {
		"cmd_type": "open",
		"info": {
			"code": 0,
			"msg": ""
		}
	}
}
//失败
{
	"code": 1001,
	"msg": "网络超时"
}
返回参数说明
参数名类型说明
codeint调用接口错误码 0成功其他异常
data.info.codeint业务错误码,0成功其他异常
data.info.msgstring业务错误信息

4.删除解绑

简要描述
  • 删除解绑,将设备从当前appid解绑

请求URL
  • https://wdev.wmj.com.cn/deviceApi/logout

请求方式
  • POST

请求格式
  • json

参数

 

{
	"app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"device_sn": "W7612345678"
}
参数名必选类型说明
app_idstring用户app_id
app_secretstring用户app_secret
device_snstring设备序列号

 

返回示例
//成功
{
    "code": 0,
    "msg": "解绑成功"
}

返回参数说明
参数名类型说明
codeint错误码 0成功其他异常
data.info.err_codeint0成功其他异常
data.info.wifi_rssiint设备信号
作者:极客师傅  创建时间:2025-03-18 23:29
最后编辑:极客师傅  更新时间:2025-04-27 12:41