获取商品列表

快手获取商品列表

一、接口名称

• 接口地址：https://kf.fw199.com/gateway/ks/item/list
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

二、请求参数

公共参数

业务参数

三、请求示例代码（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);
}

四、返回结果

4.1 成功示例

{
  "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、主图、类目等更多信息。

4.2 data 字段说明

items 常见字段