添加商品图片

添加一张商品图片到num_iid指定的商品中(添加主图边上的图片) , 传入的num_iid所对应的商品必须属于当前会话的用户 如果更新图片需要设置itemimg_id,且该itemimg_id的图片记录需要属于传入的num_iid对应的商品。如果新增图片则不用设置 。 使用taobao.item.seller.get中返回的item_imgs字段获取图片id。 商品图片有数量和大小上的限制,根据卖家享有的服务(如:卖家订购了多图服务等),商品图片数量限制不同。

1.请求参数:

请求URL:

POST https://open.fw199.com/gateway/taobao/item/upload/image

参数名 类型 说明 示例
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商品主图

2. 请求示例代码(Java)

    @Test
    public void  itemUpdateImage() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        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", "544876335798");
        // 图片序号(非必须)
        data.put("position", "1");
        // 是否将该图片设为主图,(非必须) , 可选值:true,false;默认值:false(非主图)
        data.put("is_major", "false");

         // 添加一张商品图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用 ,  商品图片内容类型:JPG;最大:3M 。支持的文件类型:jpg,jpeg,png
        String base64ImageLogo = Utils.getBase64ImageFromBinary("/Users/tony/Downloads/pdd.jpeg");
        data.put("item_img", base64ImageLogo); 
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoItemUploadImage ,data);

    }

3. 返回结果如下

返回结果如下:

{
    "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会包含失败原因。

文档更新时间: 2023-04-14 22:19   作者:admin