通过类目和属性类型,获取类目的属性列表,如果查询属性类型是关键属性、可变属性时不限制类目等级。如果查询销售属性时必须使用末级类目ID。
通过类目和属性类型,获取类目的属性列表,如果查询属性类型是关键属性、可变属性时不限制类目等级。如果查询销售属性时必须使用末级类目ID。 ps: 1、若查询关键属性、可变属性的features包含key为 “brand”,value 为“1”的,不可设置到商品上; 2、若查询销售属性,需要判断features中是否包含key为dim,代表销售属性维度 3、若查询关键属性、可变属性的features中:attrLevel,属性下沉等级 1:下沉SKU; 4、如何判断属性是否支持C店,features包含“isCStore”:“1“代表C店属性,“isCStoreRequired“:“1“代表属性是否C店必填。 5、类目属性输入方式解析,输入类型inputType是必须返回的枚举如下 1:按照单选模式解析,传属性值id 2:按照多选模式解析,传多个属性值id。如果features中是否包含key为inputPercent代表百分比,那么发品入参示例参考:材质属性,multiCateProps:[{”attrId”:”9772”,”attrValues”:[”709845”,”709860”],”expands”:[”92”,”8”],”units”:[”%”,”%”]}] 3:按照文本模式解析,自定义内容 4:日期年解析方式 ,自定义年份,会校验格式,eg:2024 5:日期月解析方式,自定义月份,会校验格式,eg:2024-01 6:日期日解析方式,自定义日,会校验格式, eg: 2024-01-01 7:数值解析方式,自定义数字 10:多输入多单位解析方式,多输入多单位组合属性规则是通过features中获取key=mutInput得到{”inputPrefix”:[”长”,”宽”,”高”],”inputUnit”:”mm”,”cm”,”m”]}获取多单位前缀或者后缀 11:地域级联解析方式,格式为空格分隔的京东四级地址ID,支持海外地址,需要调用地址服务获取实际ID。从左到右,别为一级地址ID,二级地址ID,三级地址ID,实际存储地址ID数量要看属性设置的允许数量,可能为3个也可能为2个,通过features的key=inputAreaLevel获取实际个数,inputAreaLevel:1或2或3或4,代表四级地址中的级别 15:分层属性,支持多个属性值ID,目前只支持2层。详解:如果属性是分层属性,通过attrValueList获取属性值列表,每个属性值的features字段如果包含businessParentId代表否有父级属性, 如果值是0或null代表没有父级信息,如果值是大于0的正整数代表父级属性值ID,然后通过businessParentId父级属性值ID分组,attrValueList也可以找到businessParentId属性值所对应的ID,创建商品时将父子属性值ID传入即可。
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/jd/category/findattrsbycategoryidunlimitcate
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
sign | String | 是 |
业务参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
cid | Number | 是 | 9404 | 类目id |
attributeType | Number | 否 | 4 | 属性类型:1.关键属性 3.可变属性 4.销售属性 |
field | String[] | 否 | [“attrValueList”, “attrGroup”] | 只传可选的返回的字段,attrValueList,attrGroup 最多100个 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void JDFindAttrsByCategoryIdUnlimitCate() throws Exception {
String sellerNick = Config.JDSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", sellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("cid", "9738");
// data.put("attributeType", "4");
// data.put("field", "");
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDFindAttrsByCategoryIdUnlimitCate, data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": [{
"---": {
"catId": "655",
"isRequired": "true",
"features": [{
"---": {
"fvalue": "类目属性特殊属性值样例",
"cn": "类目属性特殊属性中文含义样例",
"key": "类目属性特殊属性key样例"
}
}],
"attrGroup": {
"features": [{
"---": {
"fvalue": "fvalue样例",
"cn": "cn样例",
"key": "key样例"
}
}],
"orderSort": "1",
"name": "手机外观",
"id": "1"
},
"originCategoryId": "9404",
"orderSort": "1",
"attributeType": "3",
"name": "手机屏幕",
"inputType": "3",
"attrValueList": [{
"---": {
"attId": "100001",
"catId": "655",
"features": [{
"---": {
"fvalue": "fvalue样例",
"cn": "cn样例",
"key": "key样例"
}
}],
"orderSort": "1",
"name": "手机屏幕",
"id": "1000011"
}
}],
"id": "100001",
"graphic": "jsf/demo.jpg"
}
}]
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
3. 返回结果说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
findattrsbycategoryidunlimitcate_result | java.util.List<com.jd.pop.ware.ic.api.domain.CategoryAttrUnlimit> | 类目属性 | 类目属性 |
— id | Number | 100001 | 属性ID |
— name | String | 手机屏幕 | 属性名称 |
— catId | Number | 655 | 类目ID |
— orderSort | Number | 1 | 排序,越小越靠前 |
— attributeType | Number | 3 | 属性类型 1.关键属性 3.可变属性 4.销售属性 |
— inputType | Number | 3 | 录入方式: 1.单选 2.多选 3.可输入 4.日期年解析方式 5.日期月解析方式 6.日期日解析方式 7.数值解析方式 10.多输入多单位解析方式 11.地域级联解析方式 12.经纬度解析方式 13.时间选择器解析方式 15.分层属性,入参按照多选方式 |
— graphic | String | jsf/demo.jpg | 属性图示(图片地址) |
— isRequired | Boolean | true | 是否必填 |
— features | java.util.Set<com.jd.pop.ware.ic.api.domain.Feature> | 特性 | 特性 |
—— key | String | 类目属性特殊属性key样例 | 类目属性特殊属性key |
—— fvalue | String | 类目属性特殊属性值样例 | 类目属性特殊属性value |
—— cn | String | 类目属性特殊属性中文含义样例 | 类目属性特殊属性中文含义 |
attrValueList | java.util.List<com.jd.pop.ware.ic.api.domain.CategoryAttrValueUnlimit> | 属性值集合 | 属性值集合 |
— id | Number | 1000011 | 属性值ID |
— attId | Number | 100001 | 属性ID |
— catId | Number | 655 | 类目ID |
— name | String | 手机屏幕 | 属性值名称 |
— orderSort | Number | 1 | 排序,越小越靠前 |
— features | java.util.Set<com.jd.pop.ware.ic.api.domain.Feature> | 属性特征定义 | 属性特征定义 |
—— key | String | key样例 | 特殊属性key |
—— fvalue | String | fvalue样例 | 特殊属性value |
—— cn | String | cn样例 | 特殊属性中文含义 |
attrGroup | com.jd.pop.ware.ic.api.domain.CategoryAttrGroupUnlimit | 属性组 | 属性组 |
— id | Number | 1 | 属性组ID |
— name | String | 手机外观 | 属性组名称 |
— orderSort | Number | 1 | 排序,越小越靠前 |
— features | java.util.Set<com.jd.pop.ware.ic.api.domain.Feature> | 特征 | 特征 |
—— key | String | key样例 | 特殊属性key |
—— fvalue | String | fvalue样例 | 特殊属性value |
—— cn | String | cn样例 | 特殊属性中文含义 |
— originCategoryId | Number | 9404 | 原始类目id |