• 本api适用于序列号开头为W70B/W70R的设备,app_id和app_secret请到wdev.wmj.com.cn 填用手机号或邮箱登录获取。

 

点击下面的序号展开
1.注册设备
  • 将设备和app_id、app_secret绑定

请求URL

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

请求方式

  • POST

请求格式

  • json

参数

{
	"app_id": "",
	"app_secret": "",
	"device_sn": ""
}
参数名必选类型说明
app_idstring硬件云app_id,从wdev.wmj.com.cn登录获取。
app_secretstring硬件云app_secret,从wdev.wmj.com.cn登录获取。
device_snstring设备序列号

返回示例

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

返回参数说明

参数名类型说明
codeint错误码 0成功其他异常
msgint描述

备注

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

2.播放云语音

接口URL

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

请求方式

POST

请求类型

json

请求Body参数

{
	"app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70BAEE51CC",
	"data":{
	    "cmd_type":"play",
    	"info": {
           "tts": "欢迎您使用本自助洗车服务。为了给您和其他车主营造一个干净、整洁、舒适的洗车环境,请您在洗车过程中自觉保持现场卫生。",
            "speaker": "prompt_female_high",//默认prompt_female_high女生,prompt_kunkun为男生
            "speed": 5,//速度,一般不要动
            "num_step":2,//一般不要动
            "refresh_cache":1,//是否同样内容缓存,节省流量和加快速度
            "number_mode":"digit",//value按值播报,digit按位播报
            "buffered":0,//默认不要动
            "volume":1 //音量
        }
    }
}

成功响应示例

{
    "code": 0,
    "data": {
        "device_sn": "W70BAEE51CC",
        "msg_id": 247,
        "type": 1,
        "cmd": "play",
        "app_id": "",
        "cmd_type": "",
        "info": {
            "code": 0,
            "err_code": 0,
            "msg": "TTS started"
        }
    }
}
参数名示例值参数类型参数描述
code0Integer响应成功
data-Object数据标签
data.device_snW70BAEE51CCString序列号
data.cmd_typeplayString命令类型
data.info-Object数据信息
data.info.code0Integer响应代码
data.info.msg-String响应消息
3.云喇叭设置

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
	"app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70BAEE51CC",
	"data":{
	    "cmd_type":"setting",
    	"info": {
            "volume":3,  // 0-9,音量由小到大,默认为中间值
        }
    }
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW71F9783874String序列号
data-Object数据标签
data.cmd_typesettingString命令字
data.info-Object数据信息
data.info.volume5Integer0-9,音量由小到大,默认为中间值

成功响应示例

{
	"code": 0,
	"data": {
		"device_sn": "W70BAEE51CC",
		"cmd_type": "setting",
		"info": {
			"code": 0,
			"msg": ""
		}
	}
}
参数名示例值参数类型参数描述
code0Integer响应成功
data-Object数据标签
data.device_snW70F9766718String序列号
data.cmd_typesettingString命令字
data.info-Object数据信息
data.info.code0Integer响应成功
data.info.msg-String响应消息
4.重启

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
	"app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70BAEE51CC",
	"data": {
		"cmd_type":"restart",
		"info":{}
	}
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW70F9783874String设备序列号
data-Object数据标签
data.cmd_typerestartString命令字
data.info-Object数据信息

成功响应示例

{
	"code": 0,
	"data": {
		"device_sn": "W70BAEE51CC",
		"cmd_type": "restart",
		"info": {
			"code": 0,
			"msg": ""
		}
	}
}
参数名示例值参数类型参数描述
code0Integer响应状态0为正常
data-Object数据标签
data.device_snW70F9766718String设备序列号
data.cmd_typerestartString命令字
data.info-Object返回数据信息
data.info.code0Integer响应成功
data.info.msg-String响应消息

错误响应示例

{
	"code": 1000,
	"msg": "没有操作此设备的权限"
}
参数名示例值参数类型参数描述
code1000Integer响应状态0为正常
msg没有操作此设备的权限String消息描述
5.查询播放状态
本接口查询喇叭当前是否正在播放。设备固件70B.1.09及以上版本支持。

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
	"app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70BAEE51CC",
	"data": {
		"cmd_type":"get_play_status",
		"info":{}
	}
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW70BAEE51CCString序列号
data-Object数据标签
data.cmd_typewifi_configString命令字
data.info-Object数据信息

成功响应示例

{
	"code": 0,
	"data": {
		"device_sn": "W70BAEE51CC",
		"cmd_type": "get_play_status",
		"info": {
			"code": 0,
            "err_code": 0,
            "free_heap": 73304,
            "is_loop_playing": false,
            "is_playing": false,//true时为正在播放,false时为空闲
            "msg": ""
		}
	}
}
参数名示例值参数类型参数描述
code0Integer响应成功
data-Object数据标签
data.device_snW70BAEE51CCString序列号
data.cmd_typewifi_configString命令字
data.info-Object数据信息
data.info.code0Integer响应成功
data.info.msg-String响应消息
data.info.is_loop_playing-booltrue时为正在循环播放,false时为空闲
data.info.is_playing-booltrue时为正在播放,false时为空闲
6.播放完成回调
喇叭播放完成后,向硬件云配置的回调接口发送以下信息。
{
  "device_sn": "W70BXXXXXXX",
  "type": 2,
  "cmd_type": "tts_complete",
  "info": {
    "status": "success",
    "timestamp": 123456
  }
}
7.查询设备信息

接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
	"app_id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70BAEE51CC",
	"data": {
		"cmd_type":"getdevinfo"
	}
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW70F9783874String设备序列号
data-Object数据标签
data.cmd_typegetdevinfoString命令字

成功响应示例

{
    "code": 0,
    "data": {
        "device_sn": "W70BAEE51CC",
        "msg_id": 111,
        "type": 1,
        "cmd": "getdevinfo",
        "app_id": "",
        "cmd_type": "",
        "info": {
            "admin_pwd": "admin",
            "code": 0,
            "device_pwd": "12345687",
            "err_code": 0,
            "free_heap": 75252,
            "hw_ver": "2.0.0",
            "iccid": "KGIoT",
            "imei": "24:EC:4A:EE:51:CC",
            "msg": "",
            "net_type": "",
            "project": "W70B",
            "rssi": -20,
            "schedule_enabled_count": 1,
            "schedule_total_count": 20,
            "speaker": 0,
            "speed": 0,
            "spiffs_free": 123492,
            "spiffs_total": 775841,
            "spiffs_used": 652349,
            "sw_ver": "70B.1.09",
            "time_synced": true,
            "tone": 0,
            "volume": 4
        }
    }
}
参数名示例值参数类型参数描述
code0Integer响应状态码,0表示正常/成功
data-Object响应数据主体
data.device_snW70BAEE51CCString设备序列号
data.msg_id111Integer消息ID
data.type1Integer消息类型
data.cmdgetdevinfoString命令名称
data.app_id""String应用ID(可为空)
data.cmd_typegetdevinfoString命令字/命令类型
data.info-Object设备详细信息
data.info.admin_pwd"admin"String管理员密码
data.info.code0Integer设备端响应状态码,0表示成功
data.info.device_pwd"12345687"String设备密码
data.info.err_code0Integer错误码,0表示无错误
data.info.free_heap75252Integer剩余堆内存(字节)
data.info.hw_ver"2.0.0"String硬件版本号
data.info.iccid"KGIoT"StringSIM卡ICCID或物理地址标识
data.info.imei"24:EC:4A:EE:51:CC"StringIMEI或MAC地址
data.info.msg""String响应消息(通常为空)
data.info.net_type""String网络类型
data.info.project"W70B"String项目名称或设备型号
data.info.rssi-20Integer信号强度值(负值)
data.info.schedule_enabled_count1Integer已启用定时任务数
data.info.schedule_total_count20Integer定时任务总容量
data.info.speaker0Integer扬声器状态
data.info.speed0Integer语速(0-9)
data.info.spiffs_free123492IntegerSPIFFS剩余空间(字节)
data.info.spiffs_total775841IntegerSPIFFS总空间(字节)
data.info.spiffs_used652349IntegerSPIFFS已使用空间(字节)
data.info.sw_ver"70B.1.09"String软件版本号
data.info.time_syncedtrueBoolean时间是否已同步
data.info.tone0Integer语调(0-9)
data.info.volume4Integer音量(0-9)

错误响应示例

{
	"code": 1000,
	"msg": "没有操作此设备的权限"
}
参数名示例值参数类型参数描述
code1000Integer响应状态0为正常
msg没有操作此设备的权限String消息描述
8.开启循环播放
暂无描述

接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
	"app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70F9766718",
	"data":{
	    "cmd_type":"loop_play",
    	"info": {
            "tts":"测试",
			"interval":15,
        }
    }
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW71F9783874String序列号
data-Object数据标签
data.cmd_typeloop_playString命令字段
data.info-Object数据信息
data.info.tts5String循环播放TTS文字
data.info.interval5Integer循环播放间隔,单位: 秒(s)

成功响应示例

{
	"code": 0,
	"data": {
		"device_sn": "W70F9766718",
		"cmd_type": "loop_play",
		"info": {
			"code": 0,
			"msg": ""
		}
	}
}
参数名示例值参数类型参数描述
code0Integer响应成功
data-Object数据标签
data.device_snW70F9766718String序列号
data.cmd_typesettingString命令字
data.info-Object数据信息
data.info.code0Integer响应成功
data.info.msg-String响应消息
9.停止循环播放
暂无描述

接口状态

已完成

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
	"app_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5",
	"device_sn": "W70F9766718",
	"data":{
	    "cmd_type":"loop_stop",
    	"info": {}
    }
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW71F9783874String序列号
data-Object数据标签
data.cmd_typeloop_stopString命令字段
data.info-Object数据信息

成功响应示例

{
	"code": 0,
	"data": {
		"device_sn": "W70F9766718",
		"cmd_type": "loop_stop",
		"info": {
			"code": 0,
			"msg": ""
		}
	}
}
参数名示例值参数类型参数描述
code0Integer响应成功
data-Object数据标签
data.device_snW70F9766718String序列号
data.cmd_typesettingString命令字
data.info-Object数据信息
data.info.code0Integer响应成功
data.info.msg-String响应消息
10.查询在线状态
查询设备是否联网在线

接口URL

  • https://wdev.wmj.com.cn/deviceApi/getOnLine

请求方式

POST

Content-Type

json

请求Body参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "W70FF871E13"
}
参数名示例值参数类型是否必填参数描述
app_idxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_id
app_secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx5String硬件云app_secret
device_snW71F9783874String序列号

响应示例

{
    "code": 0,
    "data": {
        "on_line": 1 //0为离线、1为在线
    },
    "msg": "查询成功"
}
11.远程升级OTA
升级固件

接口URL

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

请求方式

POST

Content-Type

json

请求Body参数

{
    "app_id": "{{wmjv2appid}}",
    "app_secret": "{{wmjv2appsecret}}",
    "device_sn": "W70CXXXXXXX",
    "data": {
        "cmd_type": "set_ota",
        "info": {
            "url": "http://fm.wmj.com.cn/ota/W70B/W70B_V70B.1.09.bin",
            "hw_ver": "1.0.0",
            "sw_ver": "70.1.09"
        }
    }
}

具体版本号根据需要咨询工作人员,切勿乱填参数导致设备变砖。

响应示例

{
    "code": 0,//code为0,等待设备升级重启,2分钟左右。
    //其它参数
}

 

作者:极客师傅  创建时间:2026-01-21 14:56
最后编辑:极客师傅  更新时间:2026-01-28 20:27