下载消息中的视频

根据视频消息回调中的 XML 数据下载视频，并返回可访问的视频地址。

接口地址： POST /getMsgVideo

前置条件

• 当前 wId 对应的微信实例在线。
• msgId、content 来自消息回调，不建议手动拼接。
• 视频资源可能有有效期，建议收到回调后尽快下载。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
msgId	是	number	消息 ID
content	是	string	视频消息回调中的 XML 数据

请求示例

{
  "wId": "{{wId}}",
  "msgId": 1102684153,
  "content": "<?xml version=\"1.0\"?><msg><videomsg aeskey=\"cc054b6e3e98fe91a5bb16227de67023\" cdnvideourl=\"304f020100...\" cdnthumburl=\"304f020100...\" length=\"966424\" playlength=\"15\" /></msg>"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	下载结果
data.url	string	视频地址，通常 7 日内有效

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": {
    "url": "https://cdn.e-yun.example/msgVideo/50720e30-064e-4429-82c5-b6f341aae226.mp4"
  }
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 视频下载建议异步处理，避免回调处理链路阻塞。
• 返回的 url 有有效期，业务侧需要及时转存或消费。
• 如果下载失败，先确认 content 是否为完整 XML，再确认实例是否在线。