搜索类目属性值
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