新增和修改商品图片的接口,支持批量

新增和修改商品图片的接口,支持批量。colorId使用颜色销售属性(dim为1的属性)的销售属性值。如果商品没有颜色值,则商品下的sku都使用默认颜色的图片,即10个0;更新图片的时候也需要注意更新的是默认颜色的图片还是sku对应颜色的图片。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/image/write/update

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 京东的账号,对应蜂巢授权返回jdseller字段
sign String

业务参数

名称 类型 必须 示例值 描述
wareId Number 10023215098822 商品id
colorId String[] [2952011083] 颜色id(销售属性值id)。如果没有颜色id,则默认为10个0,同一种颜色ID最多支持10个。
imgId Number[] [231512900906] 图片Id(可不填)。同一种颜色最多支持10个。来源系统自动生成。
imgIndex Number[] [1,2,3,4,5,6] 图片顺序。index值:1-N,如果index存在,则直接覆盖相应index图片。同一种颜色最多支持10个。
imgUrl String[] [“jfs/t1/19059/21/18217/67421/633e3ed1Eed080bfb/fd6b0d8f820714a7.jpg”] 京东图片服务器地址,不包括前缀。例如:jfs/t2116/102/1731643157/81969/c3df941a/5670f868Nc441d4c3.jpg,同一种颜色最多支持10个。
imgZoneId String[] [54465] 图片空间中的图片Id,同一种颜色最多支持10个。(已废弃)

2. 请求示例代码(Java)

请求示例代码

 @Test
    public void     JDImageWriteUpdate() throws Exception {
        String sellerNick = Config.JDSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", sellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());

        data.put("wareId", "10024650147363");
        data.put("colorId", "4156857825");
        data.put("imgIndex","5");

        data.put("imgUrl","jfs/t1/232363/1/19595/1498/66759013Fb49a5601/e8620d87e32262af.jpg");
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDImageWriteUpdate, data);
    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": "success"
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。

文档更新时间: 2024-06-28 16:37   作者:JSL