上传商品图片

上传商品主图或商品详情图

1. 请求参数

请求URL:

POST https://kf.fw199.com/gateway/ks/item/upload/file

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
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的图片,像素480
480px以上的图片,大小小于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