全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
添加商品图片
接口地址： http://api.vv-tool.com/tool/erps/quploadpropimg
接口介绍： 添加一张商品图片到 num_iid 指定的商品中 传入的 num_iid 所对应的商品必须属于当前会话的用户 如果更新图片需要设置 itemimg_id，且该 itemimg_id 的图片记录需要属于传入的 num_iid 对应的商品。如果新增图片则不用设置 。 使用 taobao.item.seller.get 中返回的 item_imgs 字段获取图片 id。 商品图片有数量和大小上的限制，根据卖家享有的服务（如：卖家订购了多图服务等），商品图片数量限制不同。
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | Number | 是 | 店铺 id |
| id | Number | 否 | 商品图片 id(如果是更新图片，则需要传该参数) |
| num_iid | Number | 是 | 商品数字 ID，该参数必须 |
| position | Number | 否 | 图片序号 |
| image | object | 是 | 图片请上传文件对象，商品图片内容类型：JPG;最大：3M 。支持的文件类型：jpg,jpeg,png(必须本地图片) |
| is_major | Boolean | 否 | 是否将该图片设为主图，可选值：true,false;默认值：false(非主图) |
| is_rectangle | Boolean | 否 | 是否 3:4 长方形图片，绑定 3:4 主图视频时用于上传 3:4 商品主图 |
| vvtype | Number | 否 | 2 高级版（必须填 2,不填默认是 2） |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| item_img | ItemImg | 商品图片结构 | |
| --url | String | http://host/image_path | 图片地址。(绝对地址，格式：http://host/image_path) |
| withholding_money | Number | 该接口扣费金额（点券） |
返回数据
{"code": 0, "msg": "操作成功", "msec": 1469, "time": 1617270403, "data": {"withholding_money": 1,"product_propimg_upload_response": {"product_prop_img": {"id": 674443, "url": "http://host/image_path", "created": "2000-01-01 00:00:00", "modified": "2000-01-01 00:00:00"}}}}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |