通过类目和属性类型,获取类目的属性列表,如果查询属性类型是关键属性、可变属性时不限制类目等级。如果查询销售属性时必须使用末级类目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
文档更新时间: 2024-06-28 16:37   作者:JSL