异步下载消息中的视频

提交视频消息下载任务，接口立即返回任务 ID。下载结果需要通过“获取异步下载视频消息结果”接口查询。

接口地址： POST /asynGetMsgVideo

前置条件

• 当前 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.id	string	异步下载任务 ID，用于查询下载结果

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "id": "6eb5d834-1dfe-47ad-b7a5-b9f2fb60a35a"
  }
}

错误响应

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

使用建议

• 拿到 data.id 后，轮询 获取异步下载视频消息结果。
• 建议设置轮询间隔和超时时间，避免无限查询。
• 如果任务失败，优先检查原始 content 是否完整，以及实例是否在线。