添加商品图片
添加一张商品图片到num_iid指定的商品中(添加主图边上的图片) , 传入的num_iid所对应的商品必须属于当前会话的用户 如果更新图片需要设置itemimg_id,且该itemimg_id的图片记录需要属于传入的num_iid对应的商品。如果新增图片则不用设置 。 使用taobao.item.seller.get中返回的item_imgs字段获取图片id。 商品图片有数量和大小上的限制,根据卖家享有的服务(如:卖家订购了多图服务等),商品图片数量限制不同。
一、请求参数
请求URL:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| num_iid | number | 必填 , 商品数字ID | |
| item_img | string | 必填 , 图片的base64编码字符串 | |
| id | number | 非必填 , 商品图片id(如果是更新图片,则需要传该参数) | |
| position | number | 非必填 , 图片序号 | |
| is_major | Boolean | 非必填 , 是否将该图片设为主图,可选值:true,false;默认值:false(非主图) | |
| is_rectangle | Boolean | 非必填 ,是否3:4长方形图片,绑定3:4主图视频时用于上传3:4商品主图 |
二、请求示例代码
Java
@Test public void itemUpdateImage() throws Exception {
String tb_seller_nick = Config.TBSellerNick ; //业务参数 Map<String, Object> data = new HashMap<String, Object>(); data.put("appid", Config.AppId); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("tb_seller_nick", tb_seller_nick); // 宝贝Id (必须 data.put("num_iid", "1045816042211"); // 图片序号(非必须) data.put("position", "1"); // 是否将该图片设为主图,(非必须) , 可选值:true,false;默认值:false(非主图) data.put("is_major", "false"); String filePath = "/Users/miller/Downloads/demo3.jpeg"; // 签名 data.put("sign", Utils.SignObject(data,Config.AppSecret)); // 调用服务API String rsp = Utils.doHttpRequest(Config.TaoBaoItemUploadImage, data, filePath); System.out.println(rsp);
}三、返回结果
返回结果如下:
{ "code": 0, "message": "ok", "data": { "item_img": { "created": "2021-02-16 10:33:12", "id": 994788461262, "url": "https://img.alicdn.com/bao/uploaded/i4/661153176/O1CN01D5FK851ZKeZ5uhvQH_!!661153176.jpg" //图片链接地址
}, "request_id": "10jf7zssgennw" }}说明: code为0表示成功,非0为失败,message会包含失败原因。