跳转到内容
Cheeli 文档
返回官网

通过类目和属性类型，获取类目的属性列表，如果查询属性类型是关键属性、可变属性时不限制类目等级。如果查

通过类目和属性类型，获取类目的属性列表，如果查询属性类型是关键属性、可变属性时不限制类目等级。如果查询销售属性时必须使用末级类目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传入即可。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/jd/category/findattrsbycategoryidunlimitcate

公共参数

参数名称参数类型是否必须示例值参数描述
appidString是合作伙伴AppId
timestampString是1657525936当前Unix时间戳，秒
seller_nickString是38173182京东的账号，对应蜂巢授权返回jdseller字段
signString是

业务参数

名称类型必须示例值描述
cidNumber是9404类目id
attributeTypeNumber否4属性类型：1.关键属性 3.可变属性 4.销售属性
fieldString[]否[“attrValueList”, “attrGroup”]只传可选的返回的字段，attrValueList,attrGroup 最多100个

二、请求示例代码

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);
    }

三、返回结果

{
    "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会包含失败原因。

三、返回结果说明

名称类型示例值描述
findattrsbycategoryidunlimitcate_resultjava.util.List<com.jd.pop.ware.ic.api.domain.CategoryAttrUnlimit>类目属性类目属性
— idNumber100001属性ID
— nameString手机屏幕属性名称
— catIdNumber655类目ID
— orderSortNumber1排序，越小越靠前
— attributeTypeNumber3属性类型 1.关键属性 3.可变属性 4.销售属性
— inputTypeNumber3录入方式: 1.单选 2.多选 3.可输入 4.日期年解析方式 5.日期月解析方式 6.日期日解析方式 7.数值解析方式 10.多输入多单位解析方式 11.地域级联解析方式 12.经纬度解析方式 13.时间选择器解析方式 15.分层属性，入参按照多选方式
— graphicStringjsf/demo.jpg属性图示（图片地址）
— isRequiredBooleantrue是否必填
— featuresjava.util.Set<com.jd.pop.ware.ic.api.domain.Feature>特性特性
—— keyString类目属性特殊属性key样例类目属性特殊属性key
—— fvalueString类目属性特殊属性值样例类目属性特殊属性value
—— cnString类目属性特殊属性中文含义样例类目属性特殊属性中文含义
attrValueListjava.util.List<com.jd.pop.ware.ic.api.domain.CategoryAttrValueUnlimit>属性值集合属性值集合
— idNumber1000011属性值ID
— attIdNumber100001属性ID
— catIdNumber655类目ID
— nameString手机屏幕属性值名称
— orderSortNumber1排序，越小越靠前
— featuresjava.util.Set<com.jd.pop.ware.ic.api.domain.Feature>属性特征定义属性特征定义
—— keyStringkey样例特殊属性key
—— fvalueStringfvalue样例特殊属性value
—— cnStringcn样例特殊属性中文含义
attrGroupcom.jd.pop.ware.ic.api.domain.CategoryAttrGroupUnlimit属性组属性组
— idNumber1属性组ID
— nameString手机外观属性组名称
— orderSortNumber1排序，越小越靠前
— featuresjava.util.Set<com.jd.pop.ware.ic.api.domain.Feature>特征特征
—— keyStringkey样例特殊属性key
—— fvalueStringfvalue样例特殊属性value
—— cnStringcn样例特殊属性中文含义
— originCategoryIdNumber9404原始类目id