# 上传图片
# 接口调用请求说明
http请求方式:POST
https://api.weixin.qq.com/product/img/upload?access_token=xxxxxxxxx&upload_type=0&resp_type=0&height=108&width=108
# URL请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
upload_type | number | 是 | 上传类型:0-二进制流,1-图片url |
resp_type | number | 是 | 返回数据类型:0-media_id和pay_media_id,1-图片链接(商品信息相关图片请务必使用此参数得到链接) |
height | number | 否 | upload_type=0时必填,图片的高,单位:像素 |
width | number | 否 | upload_type=0时必填,图片的宽,单位:像素 |
图片上传大小限制
resp_type = 0: 2MB
resp_type = 1: 10MB
# POST包请求参数说明
参数 | 类型 | 是否必填 | 说明 |
---|---|---|---|
img_url | string | 否 | upload_type=1时必填,图片url |
# 请求示例1
curl -F media=@test.jpg "https://api.weixin.qq.com/product/img/upload?access_token=xxxxxxxxx&upload_type=0&resp_type=0&height=108&width=108"
# 回包示例1
{
"errcode": 0,
"errmsg":"ok",
"pic_file":
{
"media_id": "xlvjalsdhgas",
"pay_media_id": "asdgasvdadfa"
}
}
# 请求示例2
curl -d "{\"img_url\":\"https://xxx.com/yyy\"}" "http://api.weixin.qq.com/product/img/upload?access_token=xxxxxxxxx&upload_type=1&resp_type=1"
# 回包示例2
{
"errcode":0,
"pic_file":
{
"temp_img_url": "xxxxx"
}
}
# 注意
resp_type=1
时将会返回形如mmecimage.cn/p/{appid}/{imgKey}
的图片链接,该链接永久有效,同一张图片,无需重复调用该接口重复上传。- 接口返回的图片链接有访问频率限制,超出访问频率后,会返回
404
状态码,不要将该图片链接用于用户端(访问量较大)展示。
- 当前访问频率限制规则:
appid
维度:10000/min。imgKey
维度:100/min。
- 接口返回的图片链接,支持进行图片处理(缩放/裁剪/压缩/水印等),具体使用方法参考文档:https://cloud.tencent.com/document/product/460/53505 ,该文档内的
download_url
即为当前接口返回的图片链接
# 回包参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
pic_file.media_id | number | media_id |
pic_file.pay_media_id | string | 支付media_id |
temp_img_url | string | 图片临时url |
# 返回码
返回码 | 错误类型 |
---|---|
-1 | 系统异常 |
-2 | token太长 |
600201 | 这个链接无需进行转换,可以直接使用(域名为store.mp.video.tencent-cloud.com ,或url前缀为mmbizurl.cn/p/ ,或url前缀为mmecimage.cn/p/ ) |
101002 | 图片大小超过限制,resp_type = 0: 2MB ,resp_type = 1: 10MB |