获取商品列表

一、接口名称

• 接口地址：https://kf.fw199.com/gateway/ks/item/list

• 请求方式：POST

• Content-Type：application/x-www-form-urlencoded

二、请求参数

公共参数

参数名	类型	是否必需	说明
appid	string	必需	开发者 appid
timestamp	string	必需	时间戳（**秒**）
sign	string	必需	参数签

业务参数

参数名	类型	是否必需	说明
seller_nick	string	必需	快手店铺标识（蜂巢授权店铺 nick / shop_id）
pageNumber	string	否	页码，从 `1` 开始；需满足 `0 < pageNumber < totalPage`
pageSize	string	否	每页数量，推荐 `20`；范围 `10`～`100`，超过 100 或不传默认取 100
itemStatus	string	否	商品状态；不传 `kwaiItemId` / `relItemId` 时生效。`1` = 正常（未删除商品）
itemType	string	否	商品类型；不传 `kwaiItemId` / `relItemId` 时生效。`1` = 自建商品，`2` = 闪电购商品
kwaiItemId	string	否	快手商品 ID；传入时按单品查询
relItemId	string	否	外部商品 ID；未传 `kwaiItemId` 但传了 `relItemId` 时，按 `appkey + relItemId` 查询

三、请求示例代码

Java

@Test
public void ksItemList() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/ks/item/list";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    Long timestamp = System.currentTimeMillis() / 1000;
    data.put("timestamp", timestamp.toString());
    data.put("seller_nick", "4136153087");
    data.put("pageNumber", "1");
    data.put("pageSize", "20");
    data.put("itemStatus", "1");
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

四（一）、成功示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "totalItemCount": 123,
    "currentPageItemCount": 20,
    "currentPageNumber": 1,
    "totalPage": 7,
    "items": [
      {
        "kwaiItemId": 4193319911,
        "relItemId": "123abc",
        "title": "示例商品标题",
        "price": 9900,
        "itemStatus": 1,
        "createTime": 1560000000000,
        "updateTime": 1563422542300
      }
    ]
  }
}

注：items 内字段以快手官方文档为准，上例仅列出常用字段。实际返回可能包含 SKU、主图、类目等更多信息。

四（二）、data 字段说明

参数名	类型	说明
totalItemCount	number	符合条件的商品总数
currentPageItemCount	number	当前页商品数量
currentPageNumber	number	当前页码
totalPage	number	总页数
items	array[object]	商品列表，元素为商品摘要信息

items 常见字段

参数名	类型	说明
kwaiItemId	number	快手商品 ID，可用于 `ks/item/get` 查详情
relItemId	string	外部商品 ID
title	string	商品标题
price	number	商品价格（单位：分）
itemStatus	number	商品状态
createTime	number	创建时间（毫秒时间戳）
updateTime	number	更新时间（毫秒时间戳）