全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
添加或修改属性图片
接口地址： http://www.yunyingtool.com/papi/tool/erps/wuploadpropimg
接口介绍： 添加一张商品属性图片到 num_iid 指定的商品中
传入的 num_iid 所对应的商品必须属于当前会话的用户
图片的属性必须要是颜色的属性，这个在前台显示的时候需要和 sku 进行关联的
商品属性图片只有享有服务的卖家（如：淘宝大卖家、订购了淘宝多图服务的卖家）才能上传
商品属性图片有数量和大小上的限制，最多不能超过 24 张（每个颜色属性都有一张）。
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | String | 是 | 店铺 id |
| num_iid | Number | 是 | 商品数字 ID，必选 |
| properties | String | 是 | 属性列表。调用 taobao.itemprops.get 获取类目属性，属性必须是颜色属性，再用 taobao.itempropvalues.get 取得 vid。格式：pid:vid。 |
| image | byte[] | 否 | 属性图片内容。类型：JPG,GIF;图片大小不超过：3M |
| id | Number | 否 | 属性图片 ID。如果是新增不需要填写 |
| position | Number | 否 | 图片位置 |
| vvtype | int | 否 | 增强版 2，增强版的需要传参 2,必须传 2 |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| prop_img | PropImg | PropImg 属性图片结构 | |
| --id | Number | 1646146 | 属性图片的 id，和商品相对应 |
| --url | String | http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg | 图片链接地址 |
| --created | Date | 2000-01-01 00:00:00 | 图片创建时间 时间格式：yyyy-MM-dd HH:mm:ss |
| withholding_money | int | 该接口扣费金额（点券） |
返回数据
{'code': 0, 'msg': '操作成功', 'msec': 1469, 'time': 1617270403, 'data': {'item_propimg_upload_response': {'prop_img': {'id': 1646146, 'url': 'http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg', 'created': '2000-01-01 00:00:00'}}}}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |