跳转到内容
返回官网

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

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

一、请求参数

请求URL:

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

公共参数

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

业务参数

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

二、请求示例代码

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);
}

三、返回结果

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

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