搜索类目属性值

1.搜索类目相关的属性值信息,返回的属性值配置信息的范围与店铺类型相关
2.店铺类型与类目开放关系详情见文档《快手小店开放类目及资质一览表》

1. 请求参数

请求URL:

POST https://kf.fw199.com/gateway/ks/logistics/template/list

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 快手的店铺账号,对应蜂巢授权返回seller_nick字段
sign String

业务参数

参数名 类型 必须 示例值 详情描述
categoryId Number 1027 类目id
propId Number 123213 属性id,必填
propValue String 海贼王 属性值
cursor Number 0 游标,如果propId=102,则最大允许输入2000
limit Number 10 分页数量,最大500

2. 请求示例代码(Java)

2.1 通过url方式上传图片的示例代码
@Test
    public void  KSCategoryPropValueSearch() 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("categoryId",1609);
        data.put("propId", 690);
//        data.put("propValue", "");
        data.put("cursor", 0);
        data.put("limit", 50);
        data.put("sign", Sign(data,Config.AppSecret));
        String resp = doHttpRequest(Config.KSCategoryPropValueSearchUrl, data);
        System.out.println(resp);
    }

3. 返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "total": 29,
    "cursor": 29,
    "propValues": [
      {
        "propValueId": 12365490,
        "propValue": "一步裙"
      },
      {
        "propValueId": 12365590,
        "propValue": "蛋糕裙"
      },
      {
        "propValueId": 12365690,
        "propValue": "西装裙"
      },
      {
        "propValueId": 12365890,
        "propValue": "百褶裙"
      },
      {
        "propValueId": 12365990,
        "propValue": "牛仔裙"
      },
      {
        "propValueId": 12366590,
        "propValue": "不规则裙"
      },
      {
        "propValueId": 12366890,
        "propValue": "灯笼裙"
      },
      {
        "propValueId": 12366990,
        "propValue": "A字裙"
      },
      {
        "propValueId": 12367190,
        "propValue": "铅笔裙"
      },
      {
        "propValueId": 12367390,
        "propValue": "公主裙"
      },
      {
        "propValueId": 12367490,
        "propValue": "背带裙"
      },
      {
        "propValueId": 12367790,
        "propValue": "荷叶边裙"
      },
      {
        "propValueId": 12367890,
        "propValue": "拼接款"
      },
      {
        "propValueId": 12367990,
        "propValue": "高腰裙"
      },
      {
        "propValueId": 12368090,
        "propValue": "包臀裙"
      },
      {
        "propValueId": 12368290,
        "propValue": "蓬蓬裙"
      },
      {
        "propValueId": 12369490,
        "propValue": "花苞裙"
      },
      {
        "propValueId": 12370490,
        "propValue": "小黑裙"
      },
      {
        "propValueId": 12375890,
        "propValue": "伞裙"
      },
      {
        "propValueId": 16824367,
        "propValue": "常规"
      },
      {
        "propValueId": 50034086,
        "propValue": "大摆裙"
      },
      {
        "propValueId": 50035998,
        "propValue": "直筒裙"
      },
      {
        "propValueId": 167544106,
        "propValue": "茧型裙"
      },
      {
        "propValueId": 17014165,
        "propValue": "其他"
      },
      {
        "propValueId": 50002033,
        "propValue": "太阳花"
      },
      {
        "propValueId": 50666451,
        "propValue": "工装裙"
      },
      {
        "propValueId": 277866886,
        "propValue": "屁帘裙"
      },
      {
        "propValueId": 50006419,
        "propValue": "裙裤"
      },
      {
        "propValueId": 50034082,
        "propValue": "鱼尾裙"
      }
    ]
  },
  "trace_id": ""
}

4. 返回字段说明

返回 code为0时,说明成功,非0时,说明失败。message中会有失败原因。 其他字段说明见:https://open.kwaixiaodian.com/zone/new/docs/api?name=open.item.category.prop.value.search&version=1

文档更新时间: 2025-07-29 00:29   作者:admin