下载图片

POST

/gewe/v2/api/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=\"294774c8ac2ca8f8114e4d58d2ba78a5\" encryver=\"1\" cdnthumbaeskey=\"294774c8ac2ca8f8114e4d58d2ba78a5\" cdnthumburl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" cdnthumblength=\"2253\" cdnthumbheight=\"120\" cdnthumbwidth=\"111\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" length=\"4061\" md5=\"799ee4beed51720525232aef6a0d2ec4\" />\n\t<platform_signature></platform_signature>\n\t<imgdatahash></imgdatahash>\n</msg>"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://api.geweapi.com/gewe/v2/api/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=\"294774c8ac2ca8f8114e4d58d2ba78a5\" encryver=\"1\" cdnthumbaeskey=\"294774c8ac2ca8f8114e4d58d2ba78a5\" cdnthumburl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" cdnthumblength=\"2253\" cdnthumbheight=\"120\" cdnthumbwidth=\"111\" cdnmidheight=\"0\" cdnmidwidth=\"0\" cdnhdheight=\"0\" cdnhdwidth=\"0\" cdnmidimgurl=\"3057020100044b304902010002043904752002032f7d6d02046bb5bade020465937656042436626431373937632d613430642d346137662d626230352d3832613335353935333130630204051818020201000405004c543d00\" length=\"4061\" md5=\"799ee4beed51720525232aef6a0d2ec4\" />\n\t<platform_signature></platform_signature>\n\t<imgdatahash></imgdatahash>\n</msg>"
}'

返回响应

🟢200成功

application/json

Body

ret

integer

必需

msg

string

必需

data

object

必需

fileUrl

string

必需

图片链接地址，7天有效

示例

{
    "ret": 200,
    "msg": "操作成功",
    "data": {
        "fileUrl": "http://wxapii.oos-sccd.ctyunapi.cn/20240102/wx_HJDZOY09-ucKMhzu8jQ2Z/6752deb0-cf43-4180-888a-4fb564fca4f9.png?AWSAccessKeyId=9e882e7187c38b431303&Expires=1704768119&Signature=NTu8u1S3Q9GlvCtSsfGGiAYlSCk%3D"
    }
}

修改于 2025-05-13 06:56:04

下载文件

下载语音