下载图片

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

接口地址： POST /getMsgImg

前置条件

• 当前 wId 对应的微信实例在线。
• msgId、content 来自消息回调，不建议手动拼接。
• 部分图片可能只有高清图、常规图或缩略图中的一种，下载失败时可切换 type 重试。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
msgId	是	number	消息 ID
content	是	string	图片消息回调中的 XML 数据
type	否	int	图片类型：0 常规图片，1 高清图

请求示例

{
  "wId": "{{wId}}",
  "msgId": 1102684156,
  "content": "<?xml version=\"1.0\"?><msg><img aeskey=\"07fea09b27952d512c0d71a52c914f3\" cdnthumburl=\"305802010004...\" cdnmidimgurl=\"305802010004...\" length=\"51361\" md5=\"449fb858f24416adcab831859011fb21\" /></msg>",
  "type": 0
}

响应参数

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

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": {
    "url": "https://cdn.e-yun.example/msgImg/dd32565c-78b0-4803-a330-6293b05674d9.png"
  }
}

错误响应

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

使用建议

• 优先使用消息回调原始 XML，不要只复制其中部分字段。
• 下载失败时先切换 type=0/1 重试，再排查 wId 是否在线。
• 返回的 url 有有效期，业务侧需要及时转存或消费。