# 上传图片

# 接口调用请求说明

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状态码,不要将该图片链接用于用户端(访问量较大)展示。
  • 当前访问频率限制规则:
  1. appid维度:10000/min。
  2. 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: 2MBresp_type = 1: 10MB