上传商品图片
上传商品主图或商品详情图
1. 请求参数
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 快手的店铺账号,对应蜂巢授权返回seller_nick字段 |
sign | String | 是 |
业务参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
img_url | String | 是 | 图片来源 | |
upload_type | int | 是 | 1 | 1(商品主图),长宽比为1:1的图片、 2(商品详情图)、 3(sku图片),长宽比为1:1的图片、 4(类目属性图片)、 5(商品白底图,请上传格式为png/jpeg/jpg的图片,长宽比为1:1的图片,像素480480px以上的图片,大小小于2M)、 6(商品透明图,请上传格式为png的图片,长宽比为1:1的图片,像素480480px以上的图片,大小小于2M)、 9(标品图片) |
from | int | 是 | 0 | 图片上传方式,0: 本地文件上传,1:通过url上传,将img_url图片直接上传到快手图片空间。 |
file | File | 可选 | 当from为0时, 通过本地文件上传图片。必填。 |
2. 请求示例代码(Java)
2.1 通过url方式上传图片的示例代码
@Test
public void UploadimageSync() throws Exception {
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("seller_nick", Config.KSSellerNick);
// 通过url上传图片示例
data.put("img_url","https://cbu01.alicdn.com/img/ibank/O1CN01iYAWn81J4b81Vjl8e_!!3482710975-0-cib.jpg" );
data.put("upload_type", 1);
data.put("from", 1); // 0: 本地上传, 1:通过url上传, img_url即可要下载的图片地址
data.put("sign", Sign(data,Config.AppSecret));
String resp = doHttpRequest(Config.KSUploadFileUrl, data);
System.out.println(resp);
}
2.2 通过本地文件方式上传图片的示例代码
@Test
public void UploadimageSync() throws Exception {
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("seller_nick", Config.KSSellerNick);
// 本地上传图片示例
data.put("img_url","https://cbu01.alicdn.com/img/ibank/O1CN01LezKDm1J4b8493zZb_!!3482710975-0-cib.jpg" );
data.put("upload_type", 1);
data.put("from", 0); // 0: 本地上传, 1:通过url上传, img_url即可要下载的图片地址
String filePath = "/Users/miller/working/demodata/img-validate/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg";
data.put("sign", Sign(data,Config.AppSecret));
String resp = doHttpRequest(Config.KSUploadFileUrl, data,filePath);
System.out.println(resp);
}
3. 返回结果
{
"code": 0,
"message": "ok",
"data": {
"originImgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01iYAWn81J4b81Vjl8e_!!3482710975-0-cib.jpg",
"kwaiImgUrl": "https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-4dc5ea314dea401b90e2372bfc64d743.jpg"
},
"trace_id": ""
}
4. 返回字段说明
返回 code为0时,说明成功,非0时,说明失败。message中会有失败原因。
字段 | 类型 | 示例 | 说明 |
---|---|---|---|
originImgUrl | String | 原始图片url | |
kwaiImgUrl | String | 快手图片url |
文档更新时间: 2025-07-28 16:41 作者:admin