新增和修改商品图片的接口,支持批量
新增和修改商品图片的接口,支持批量。colorId使用颜色销售属性(dim为1的属性)的销售属性值。如果商品没有颜色值,则商品下的sku都使用默认颜色的图片,即10个0;更新图片的时候也需要注意更新的是默认颜色的图片还是sku对应颜色的图片。
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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