获取类目相关配置信息
1.获取类目相关配置信息，返回的类目配置信息的范围与店铺类型相关
2.店铺类型与类目开放关系详情见文档《快手小店开放类目及资质一览表》https://www.kwaixiaodian.com/rules?id=tjYW6tntgd
1. 请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 快手的店铺账号，对应蜂巢授权返回seller_nick字段 |
| sign | String | 是 |
业务参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| categoryId | int | 是 | 类目的叶子节点 |
2. 请求示例代码(Java)
2.1 通过url方式上传图片的示例代码
@Test
public void GetCategoryConfig() 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("sign", Sign(data,Config.AppSecret));
String resp = doHttpRequest(Config.KSItemCategoryConfigUrl, data);
System.out.println(resp);
}3. 返回结果
{
"code": 0,
"message": "ok",
"data": {
"categoryConfig": {
"refundRuleList": [
1
],
"preSaleTime": 30,
"allergyRefund": "0",
"freshRotRefund": "0",
"brokenRefund": "2"
},
"categoryPropSwitch": true,
"propConfigs": [
{
"propId": 102,
"propName": "品牌",
"preConstraint": false,
"prePropValues": [],
"required": true,
"propValueMaximum": 0,
"sortNum": 22,
"propInputConfig": null,
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 244,
"propName": "适用年龄",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 8,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": false,
"max": 0,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 690,
"propName": "裙型",
"preConstraint": false,
"prePropValues": [],
"required": true,
"propValueMaximum": 0,
"sortNum": 19,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": false,
"max": 1,
"min": 1,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 2616,
"propName": "安全等级",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 3765,
"propName": "风格",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 20,
"sortNum": 15,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"\\u4E00-\\u9FA5",
"0-9",
"a-zA-Z"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入中文、数字、英文"
},
"imageInputConfig": null
},
"propInputType": "CHECKBOX",
"unitProp": [],
"customInput": false
},
{
"propId": 3766,
"propName": "适用季节",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 20,
"sortNum": 13,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": false,
"max": 0,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "CHECKBOX",
"unitProp": [],
"customInput": false
},
{
"propId": 3767,
"propName": "裙长",
"preConstraint": false,
"prePropValues": [],
"required": true,
"propValueMaximum": 0,
"sortNum": 18,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"\\u4E00-\\u9FA5",
"0-9",
"a-zA-Z"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入中文、数字、英文"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 3942,
"propName": "厚度",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 7,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": false,
"max": 0,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 3944,
"propName": "版型",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 4516,
"propName": "图案",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 20,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "CHECKBOX",
"unitProp": [],
"customInput": false
},
{
"propId": 4565,
"propName": "面料分类",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": true,
"max": 50,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": true
},
{
"propId": 4805,
"propName": "货号",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 6,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": true,
"max": 50,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": true
},
{
"propId": 5032,
"propName": "克重",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": true,
"max": 200,
"min": 0,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "TEXT",
"unitProp": [
{
"unitPropValueId": 339170972,
"unitPropValueName": "g"
}
],
"customInput": false
},
{
"propId": 5505,
"propName": "成分含量",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 9,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": false,
"max": 0,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 5530,
"propName": "裙门襟",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 5540,
"propName": "流行元素/工艺",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 20,
"sortNum": 14,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"\\u4E00-\\u9FA5",
"0-9",
"a-zA-Z"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入中文、数字、英文"
},
"imageInputConfig": null
},
"propInputType": "CHECKBOX",
"unitProp": [],
"customInput": false
},
{
"propId": 5544,
"propName": "面料材质",
"preConstraint": false,
"prePropValues": [],
"required": true,
"propValueMaximum": 20,
"sortNum": 21,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"\\u4E00-\\u9FA5",
"0-9",
"a-zA-Z"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入中文、数字、英文"
},
"imageInputConfig": null
},
"propInputType": "CHECKBOX",
"unitProp": [],
"customInput": false
},
{
"propId": 5551,
"propName": "上市年份季节",
"preConstraint": false,
"prePropValues": [],
"required": true,
"propValueMaximum": 0,
"sortNum": 12,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [],
"useLimit": true,
"max": 50,
"min": 0,
"message": "允许输入中文、英文、空格、数字、特殊字符等"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": true
},
{
"propId": 5587,
"propName": "腰型",
"preConstraint": false,
"prePropValues": [],
"required": true,
"propValueMaximum": 0,
"sortNum": 17,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"\\u4E00-\\u9FA5",
"0-9",
"a-zA-Z"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入中文、数字、英文"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 5591,
"propName": "里料材质",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
},
{
"propId": 6484,
"propName": "吊牌图（材质成分）",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": null,
"imageInputConfig": {
"minCount": 1,
"maxCount": 5,
"minWidth": 0,
"minHeight": 0
}
},
"propInputType": "IMAGE",
"unitProp": [],
"customInput": false
},
{
"propId": 6549,
"propName": "是否有内衬",
"preConstraint": false,
"prePropValues": [],
"required": false,
"propValueMaximum": 0,
"sortNum": 0,
"propInputConfig": {
"dateInputConfig": null,
"inputFormatConfig": {
"patternList": [
"([1-9][0-9]*(\\.[0-9]+)?|0\\.[0-9]*[1-9][0-9]*)"
],
"useLimit": false,
"max": 1,
"min": 1,
"message": "只允许输入数值（指正数）"
},
"imageInputConfig": null
},
"propInputType": "RADIO",
"unitProp": [],
"customInput": false
}
]
},
"trace_id": ""
}4. 返回字段说明
返回 code为0时，说明成功，非0时，说明失败。message中会有失败原因。 其他字段说明见: https://open.kwaixiaodian.com/zone/new/docs/api?name=open.item.category.config&version=1
文档更新时间: 2025-07-28 17:49 作者：admin
