1.注册设备
将设备注册到硬件云平台,和appid绑定。
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212"
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
成功响应示例
{
"code": 0,
"msg": "注册成功"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| msg | 注册成功 | String | 消息描述 |
2.查询设备是否在线
查询设备在线状态
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212"
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件平台的appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件平台的appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
成功响应示例
{
"code": 0,
"data": {
"on_line": 1
},
"msg": "查询成功"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | |
| data | - | Object | |
| data.on_line | 1 | Integer | 1在线,0离线 |
| msg | 查询成功 | String | |
3.开门
触发继电器接通,执行开门
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"unlock",
"delaytime":"1500",
"volume":3
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81495671 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | unlock | String | 是 | 开门指令 |
| data.delaytime | 1000 | String | 是 | 继电器延时时间,单位毫秒 |
| data.volume | 3 | Integer | 是 | 音量大小1-7 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81075212",
"msg_id": "d460",
"type": 1,
"cmd": "unlock_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | d460 | String | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | unlock_ack | String | 开门反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 开门成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
4.主动获取门状态
主动获取门状态
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"getstatus"
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81495671 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | getstatus | String | 是 | 获取设备信息指令 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81495671",
"msg_id": 32,
"type": 1,
"cmd": "getstatus_ack",
"info": {
"doorstatus": 1,
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81495671 | String | 设备序列号 |
| data.msg_id | 32 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | getstatus_ack | String | 获取设备信息指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.doorstatus | 1 | Integer | 门打开状态为1关闭状态为0 |
| data.info.status | 1 | Integer | 预留 |
5.禁用门禁开启有人模式
禁用门禁开启有人模式
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"ctrlrelay",
"relay":0,
"openttscontent":"门已常开,开启有人模式",
"volume":5
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81495770 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | ctrlrelay | String | 是 | 控制指令 |
| data.relay | 0 | Integer | 是 | 值为0时继电器断开,值为1时继电器常通 |
| data.openttscontent | 门已常开,开启有人模式 | String | 是 | 语音提示字符 |
| data.volume | 5 | Integer | 是 | 音量大小1-7 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81495770",
"msg_id": 289,
"type": 1,
"cmd": "ctrlrelay_ack",
"info": {
"relaystatus": 0
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81495770 | String | 设备序列号 |
| data.msg_id | 289 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | ctrlrelay_ack | String | 开门反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.relaystatus | 0 | Integer | 值为0时继电器断开,值为1时继电器常通 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
6.主动获取设备信息
主动获取设备信息
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"getdevinfo"
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | getdevinfo | String | 是 | 获取设备信息指令 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81495671",
"msg_id": 35,
"type": 1,
"cmd": "getdevinfo_ack",
"info": {
"iccid": "89860478102091424203",
"imei": "866250061495671",
"project": "Air724_LTEQRNFM_CHAOSHI",
"rssi": 20,
"version": "0.0.4"
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81495671 | String | 设备序列号 |
| data.msg_id | 35 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | getdevinfo_ack | String | 获取设备信息指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.iccid | 89860478102091424203 | String | 设备安装的sim卡的ICCID号 |
| data.info.imei | 866250061495671 | String | 设备的IMEI号 |
| data.info.project | Air724_LTEQRNFM_CHAOSHI | String | 设备项目名称 |
| data.info.rssi | 20 | Integer | 设备信号强度 |
| data.info.version | 0.0.4 | String | 固件版本 |
错误响应示例
{
"code": 1001,
"msg": "网络超时"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1001 | Integer | 响应状态0为正常,1001为异常 |
| msg | 网络超时 | String | 消息描述 |
7.启用门禁开启无人模式
启用门禁开启无人模式,控制继电器导通
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"ctrlrelay",
"relay":1,
"openttscontent":"门禁已启用,开启无人模式",
"volume":5
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81495770 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | ctrlrelay | String | 是 | 控制指令 |
| data.relay | 1 | Integer | 是 | 值为0时继电器断开,值为1时继电器常通 |
| data.openttscontent | 门禁已启用,开启无人模式 | String | 是 | 语音提示字符 |
| data.volume | 5 | Integer | 是 | 音量大小1-7 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81075212",
"msg_id": "d460",
"type": 1,
"cmd": "unlock_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | d460 | String | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | unlock_ack | String | 开门反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 开门成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
8.主动获取设备LBS信息
主动获取设备LBS信息
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"getlbs"
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | getlbs | String | 是 | 获取设备信息指令 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81495671",
"msg_id": 40,
"type": 1,
"cmd": "getlbs_ack",
"info": {
"lat": "026.5495834",
"lng": "106.6774832"
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81495671 | String | 设备序列号 |
| data.msg_id | 40 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | getlbs_ack | String | 获取设备信息指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.lat | 026.5495834 | String | 纬度 |
| data.info.lng | 106.6774832 | String | 经度 |
9.设置MP3文件
设置MP3文件
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"downloadaudio",
"urlpath":"https://wxapp.wmj.com.cn/audio/",
"openaudio":"open.mp3",
"closeaudio":"closedoor.mp3",
"welcomeaudio":"welcome.mp3"
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81495671 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | downloadaudio | String | 是 | 指令 |
| data.urlpath | wxapp.wmj.com.cn/aud... | String | 是 | 存放mp3文件的网站目录,注意最后要有斜杠 |
| data.openaudio | open.mp3 | String | 是 | 开门语音文件小于50KB |
| data.closeaudio | closedoor.mp3 | String | 是 | 关门语音文件小于50KB |
| data.welcomeaudio | welcome.mp3 | String | 是 | 检测到人时的语音文件小于50KB |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81495671",
"msg_id": "d460",
"type": 1,
"cmd": "downloadaudio_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | d460 | String | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | unlock_ack | String | 开门反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 开门成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
10.重启设备
重启设备,有时主动云升级设备需要重启
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"restart"
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件平台的appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件平台的appsecret |
| device_sn | WMJ81495671 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型 |
| data | - | Object | 是 | - |
| data.cmd | restart | String | 是 | 指令 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81495671",
"msg_id": 41,
"type": 1,
"cmd": "restart_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | |
| data | - | Object | |
| data.device_sn | WMJ81495671 | String | |
| data.msg_id | 41 | Integer | |
| data.type | 1 | Integer | |
| data.cmd | restart_ack | String | 指令 |
| data.info | - | Object | |
| data.info.status | 1 | Integer | 成功 |
11.设备上线回调
设备上线时主动向回调地址报告一条信息,用户业务逻辑自己保存处理,便于设备管理维护。
接口状态
已完成
接口URL
填写的回调地址会收到
请求方式
POST
Content-Type
json
报告的数据格式
{"cmd":"OnLine","device_sn":"WMJ81075212"}
12.设备离线回调
设备离线时向用户报告设备离线,便于设备维护管理。
接口状态
已完成
接口URL
填写的回调地址会收到
请求方式
POST
Content-Type
json
报告的数据格式
{"cmd":"OffLine","device_sn":"WMJ81075212"}
13.门状态变化回调
当接有门状态检测传感器时,将传感器状态主动上报到用户业务系统,便于管理维护
接口状态
已完成
接口URL
填写的回调地址会收到
请求方式
POST
Content-Type
json
请求Body参数
{"device_sn":"WMJ81075212","msg_id":"","type":2,"cmd":"replystatus1","info":{"doorstatus":0}}
14.存在检测回调
一般接PIR传感器检测是否有人存在,有就上报信息
接口状态
已完成
接口URL
填写的回调地址会收到
请求方式
POST
Content-Type
json
上报的数据结构
{"device_sn":"WMJ81075212","msg_id":"","type":2,"cmd":"replystatus2","info":{"existstatus":0}}
15.TTS云喇叭播报
用于向设备发送文本,门禁机将文本用语音播报。
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"cloudspeaker",
"ttscontent":"你好,请带好随身物品,关好门离开",
"volume":5
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | cloudspeaker | String | 是 | 指令 |
| data.ttscontent | 你好,请带好随身物品,关好门离开 | String | 是 | 播报内容 |
| data.volume | 5 | Integer | 是 | 音量大小1-7 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81075212",
"msg_id": 1236,
"type": 1,
"cmd": "cloudspeaker_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | 1236 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | cloudspeaker_ack | String | 反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
16.功能配置
用于设置特定参数
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81495770",
"type":1,
"data": {
"cmd":"func",
"lock_state":1
}
}
17.让设备播放警报音频
让设备播放警报音频
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data": {
"cmd":"alarm",
"volume":5
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | alarm | String | 是 | 指令,播放警报音频 |
| data.volume | 5 | Integer | 是 | 音量大小1-7 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81075212",
"msg_id": 1236,
"type": 1,
"cmd": "cloudspeaker_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | 1236 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | cloudspeaker_ack | String | 反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
18.设置
让设备播放警报音频
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data":{
"cmd":"setting",
"volume":6,
"pir_interval_time": 30,
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | setting | String | 是 | 设置 |
| data.volume | 5 | Integer | 否 | 音量大小0-7 |
| data.pir_interval_time | 30 | Integer | 否 | 人体感应器最少触发间隔(单位秒) |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81075212",
"msg_id": 1236,
"type": 1,
"cmd": "setting_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | 1236 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | setting_ack | String | 反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |
19.重置语音
重置开门、关门、人体感应语音为初始状态
接口状态
已完成
接口URL
wdev.wmj.com.cn/devi...
请求方式
POST
Content-Type
json
请求Body参数
{
"app_id":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"app_secret":"xxx2cexax12x2axcxx5a94fe5f3xx0xx",
"device_sn": "WMJ81075212",
"type":1,
"data":{
"cmd":"reset_audio"
}
}
| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
|---|
| app_id | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appid |
| app_secret | xxx2cexax12x2axcxx5a94fe5f3xx0xx | String | 是 | 硬件云appsecret |
| device_sn | WMJ81075212 | String | 是 | 设备序列号 |
| type | 1 | Integer | 是 | 指令类型1为主动请求,2为设备自动上报到回调url |
| data | - | Object | 是 | 数据标签 |
| data.cmd | reset_audio | String | 是 | 设置 |
成功响应示例
{
"code": 0,
"data": {
"device_sn": "WMJ81075212",
"msg_id": 1236,
"type": 1,
"cmd": "reset_audio_ack",
"info": {
"status": 1
}
}
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 0 | Integer | 响应状态0为正常 |
| data | - | Object | 数据标签 |
| data.device_sn | WMJ81075212 | String | 设备序列号 |
| data.msg_id | 1236 | Integer | 消息id |
| data.type | 1 | Integer | 指令类型1为主动请求,2为设备自动上报到回调url |
| data.cmd | reset_audio_ack | String | 反馈指令 |
| data.info | - | Object | 返回数据信息 |
| data.info.status | 1 | Integer | 成功反馈 |
错误响应示例
{
"code": 1000,
"msg": "没有操作此设备的权限"
}
| 参数名 | 示例值 | 参数类型 | 参数描述 |
|---|
| code | 1000 | Integer | 响应状态0为正常 |
| msg | 没有操作此设备的权限 | String | 消息描述 |