# 上传图片
# 接口调用请求说明
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: 2MBresp_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://URL地址/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 |