请求URL

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

请求方式

POST

请求格式

json

参数

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

返回示例

{
  "code": 0,
  "msg": "注册成功"
}

简要描述

查询设备是否连接硬件云。本接口只读取平台在线记录，不向设备发送命令。

请求URL

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

请求方式

POST

参数

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

返回示例

{
  "code": 0,
  "msg": "查询成功",
  "data": {
    "on_line": 1
  }
}

简要描述

查询设备版本、4G 信号、录音状态、待上传数量和最近一次录音及上传结果。设备必须在线。

请求URL

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

请求方式

POST

参数

{
  "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_type": "getdevinfo",
    "info": {
      "code": 0,
      "msg": "",
      "project": "W706",
      "sw_ver": "706.1.2",
      "hw_ver": "1.0.0",
      "rssi": -71,
      "csq": 21,
      "recording": false,
      "uploading": false,
      "upload_queue_count": 0,
      "last_size": 15360,
      "last_duration": 6,
      "last_upload_code": 200,
      "last_error": ""
    }
  }
}

响应可能同时包含设备和 SIM 网络标识字段。客户系统应按最小必要原则保存，不应公开这些标识。

简要描述

设置客户服务用于接收录音文件的 HTTP 或 HTTPS 地址。配置写入设备后会持久保存，重启后继续生效。

生产环境应使用 HTTPS，并保证接口可从公网访问。接收地址不应包含公开可见的账号密码。

请求URL

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

请求方式

POST

参数

{
  "app_id": "{{wmjv2appid}}",
  "app_secret": "{{wmjv2appsecret}}",
  "device_sn": "{{device_sn}}",
  "type": 1,
  "data": {
    "cmd_type": "set_cloud_config",
    "info": {
      "upload_url": "https://example.com/api/voice/upload"
    }
  }
}

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "set_cloud_config",
    "info": {
      "code": 0,
      "msg": "",
      "upload_url": "https://example.com/api/voice/upload"
    }
  }
}

配置后建议调用“查询设备信息”，核对返回的 upload_url。如需配置多台设备，应分别向每台 W706 下发。

简要描述

让在线设备开始一次录音。设备已经在录音或正在结束上一条录音时会返回失败。现场按键录音不依赖网络，不需要调用本接口。

请求URL

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

请求方式

POST

参数

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

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "start_record",
    "info": {
      "code": 0,
      "msg": ""
    }
  }
}

录音灯会在开始请求时亮起。再次按下设备按键、调用停止录音命令或达到 60 秒，都会结束本次录音。

简要描述

结束当前录音。设备没有正在录音时会返回失败。结束后设备先保存文件，再根据网络状态立即上传或加入待传队列。

请求URL

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

请求方式

POST

参数

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

返回示例

{
  "code": 0,
  "data": {
    "device_sn": "{{device_sn}}",
    "cmd_type": "stop_record",
    "info": {
      "code": 0,
      "msg": ""
    }
  }
}

简要描述

W706 使用 HTTP POST 把 AMR-WB 音频二进制直接写入请求体。该请求不是 JSON，也不是 multipart/form-data。

客户服务应尽快完成校验和文件落盘，然后返回 HTTP 2xx。语音识别应异步执行，不要阻塞设备上传请求。

请求URL

由“配置音频接收地址”设置，例如：

https://example.com/api/voice/upload

请求方式

POST

Content-Type

audio/amr

请求示例

POST /api/voice/upload?device_sn={{device_sn}}&project=W706&version=706.1.2&duration=6 HTTP/1.1
Host: example.com
Content-Type: audio/amr
Content-Length: 15360
X-Device-Sn: {{device_sn}}
X-Project: W706
X-Version: 706.1.2
X-Audio-Duration: 6

<AMR-WB 音频二进制内容>

Query 参数

Header

音频参数

成功响应示例

{
  "code": 0,
  "msg": "",
  "data": {
    "id": "voice_record_id",
    "device_sn": "{{device_sn}}",
    "duration": 6,
    "size": 15360
  }
}

设备主要根据 HTTP 状态码判断上传是否成功。成功时必须返回 200 至 299；请求超时、网络失败或返回非 2xx 时，设备保留本地文件并在后续联网时重试。

失败响应示例

{
  "code": 1,
  "msg": "invalid audio body",
  "data": null
}

服务端处理要求

1. 校验 Content-Length，拒绝空文件。
2. 读取完整请求体，按二进制方式保存为 .amr 文件。
3. 记录设备序列号、录音时长、文件大小和接收时间。
4. 文件保存成功后立即返回 HTTP 2xx。
5. 语音转文字、内容审核等耗时任务放入异步队列处理。
6. 建议单文件限制不小于 1 MB，请求超时时间不小于 120 秒。
7. 建议按设备号和接收时间生成唯一业务 ID，并做好重复上传的幂等处理。

X-Device-Sn 等 Header 用于标识和核对，不是密码或签名。生产服务应使用 HTTPS，并在服务端校验已绑定的设备号、访问来源和业务权限。

简要描述

设备会通过硬件云上报录音开始、录音结束和上传结果。客户回调服务可按 cmd_type 区分事件，并使用业务唯一键避免重复处理。

录音开始

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "record_start",
  "info": {
    "path": "/w706_rec_1.amr",
    "max_seconds": 60,
    "record_type": "AMR_WB",
    "sample_rate": 16000,
    "bits": 16,
    "channels": 1
  }
}

录音结束

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "record_stop",
  "info": {
    "reason": "button",
    "path": "/w706_rec_1.amr",
    "size": 15360,
    "duration": 6
  }
}

reason 常见值：button 表示按键结束，mqtt 表示远程命令结束，timeout 表示达到 60 秒自动结束，empty_audio 表示没有形成有效音频。

上传结果

{
  "device_sn": "{{device_sn}}",
  "type": 2,
  "cmd_type": "record_upload",
  "info": {
    "status": "ok",
    "code": 200,
    "size": 15360,
    "duration": 6,
    "body": "{\"code\":0,\"msg\":\"\"}"
  }
}

W706 只负责采集和上传音频，不提供语音识别结果。客户服务收到 .amr 文件后，可调用自有或第三方语音识别服务。

• 识别服务支持 AMR-WB 时，可直接提交原文件。
• 识别服务不支持 AMR-WB 时，可先转换为 16 kHz 单声道 WAV。
• “音频接收成功”和“文字识别完成”应作为两个独立状态处理。
• 设备上传接口不要等待识别完成，以免超时后重复上传。
• 识别结果应通过录音业务 ID 与原始文件关联，不建议只用文件名关联。

为什么收到的文件无法播放？

确认服务端按二进制读取完整请求体，并以 .amr 后缀保存；不要把请求体当作 JSON、文本或表单解析。还应核对文件大小与 Content-Length 是否一致。

为什么会收到较早时间的录音？

设备离线时会保存录音，网络恢复后按队列补传。因此服务端接收时间不一定等于实际录音时间，业务系统应保留接收时间，并以设备上报的时长作为辅助信息。

为什么同一条录音可能重复到达？

设备只有在收到 HTTP 2xx 后才删除本地待传文件。如果服务端已经保存文件但响应超时，设备会再次上传。客户服务应使用设备号、文件内容摘要、时长和接收时间窗口做幂等判断。

无网络时按键还能录音吗？

可以。按键录音不依赖网络；网络只影响上传。待传队列最多保留 20 条，长时间离线时应及时恢复网络，避免最早的录音被循环清理。

接收接口需要直接返回识别文字吗？

不需要。设备只判断 HTTP 状态码，不读取识别文字。建议先保存音频并返回成功，再异步完成语音识别。

请求URL

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

请求方式

POST

参数

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

返回示例

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

解绑后，客户账号不能再通过 APIv2 向该设备发送命令。解绑不会删除客户服务器已经接收的音频文件。

更新记录