Gewechat

下载图片

POST

/message/downloadImage

注意如果下载图片失败，可尝试下载另外两种图片类型，并非所有图片都会有高清、常规图片

请求参数

Header 参数

X-GEWE-TOKEN

string

必需

示例值:

Body 参数application/json

appId

string

设备ID

必需

xml

string

回调消息中的XML

必需

type

integer

必需

下载的图片类型 1:高清图片 2:常规图片 3:缩略图

默认值:

示例

{
  "appId": "{{appid}}",
  "type": 2,
  "xml": "<?xml version=\"1.0\"?>\n<msg>\n\t<img aeskey=\"83721f32eeab053f06317c1de5138461\" encryver=\"1\" cdnthumbaeskey=\"83721f32eeab053f06317c1de5138461\" cdnthumburl=\"3057020100044b30490201000204a2b473b402032f7efd02045b04d83a020466bb1a2c042464303334643966392d363639312d343439632d393463302d373033346237333331396561020405150a020201000405004c505500\" cdnthumblength=\"5785\" cdnthumbheight=\"120\" cdnthumbwidth=\"120\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b30490201000204a2b473b402032f7efd02045b04d83a020466bb1a2c042464303334643966392d363639312d343439632d393463302d373033346237333331396561020405150a020201000405004c505500\" length=\"9557\" md5=\"db3de4c78bc00837a32ed753a179c336\" hevc_mid_size=\"9557\" originsourcemd5=\"d5314bba593a09f61df100ba635b440e\" />\n\t<platform_signature />\n\t<imgdatahash />\n\t<ImgSourceInfo>\n\t\t<ImgSourceUrl />\n\t\t<BizType>0</BizType>\n\t</ImgSourceInfo>\n</msg>\n"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/message/downloadImage' \
--header 'X-GEWE-TOKEN: {{gewe-token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "{{appid}}",
    "type": 2,
    "xml": "<?xml version=\"1.0\"?>\n<msg>\n\t<img aeskey=\"83721f32eeab053f06317c1de5138461\" encryver=\"1\" cdnthumbaeskey=\"83721f32eeab053f06317c1de5138461\" cdnthumburl=\"3057020100044b30490201000204a2b473b402032f7efd02045b04d83a020466bb1a2c042464303334643966392d363639312d343439632d393463302d373033346237333331396561020405150a020201000405004c505500\" cdnthumblength=\"5785\" cdnthumbheight=\"120\" cdnthumbwidth=\"120\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b30490201000204a2b473b402032f7efd02045b04d83a020466bb1a2c042464303334643966392d363639312d343439632d393463302d373033346237333331396561020405150a020201000405004c505500\" length=\"9557\" md5=\"db3de4c78bc00837a32ed753a179c336\" hevc_mid_size=\"9557\" originsourcemd5=\"d5314bba593a09f61df100ba635b440e\" />\n\t<platform_signature />\n\t<imgdatahash />\n\t<ImgSourceInfo>\n\t\t<ImgSourceUrl />\n\t\t<BizType>0</BizType>\n\t</ImgSourceInfo>\n</msg>\n"
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

data

object

必需

fileUrl

string

必需

图片链接地址，7天有效

示例

{
  "ret": 200,
  "msg": "操作成功",
  "data": {
    "fileUrl": "/download/20240720/wx_BTVoJ_o_r6DpxNCNiycFE/0ca5b675-8e2c-4dc1-b288-3c44a40086ec4"
  }
}

回调消息详解

发送文字消息