标品搜索，传入条件大部分是非必填

使用类目、品牌等条件搜索标品，传入条件大部分是非必填

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/jd/cspu/search

公共参数

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

业务参数

名称	类型	必须	示例值	描述
categoryId	Number[]	是	28288	类目ID，来自类目接口，最多传入10个
uniqueCode	String[]	是	6902088919387	关键属性，来自商品接口，最多传入10个
pageNo	Number	是	1	页号
pageSize	Number	是	20	页码
brandId	Number[]	是	23423	品牌ID，来自品牌接口，最多传入10个
appName	String	是	应用名称	app名称
ip	String	是	127.0.0.1	如果调用方本身是一个代理（比如jos），这里应该传入真正调用来源的ip地址
userAgent	String	是	zhangsan	操作人/系统名称
spuId	Number	否	12344	父标品id
key	String[]	否	32	特殊属性key，最多传入10组
value	String[]	否	1	特殊属性value，最多传入10组

二、请求示例代码

Java

请求示例代码

@Test
    public void     JDCspuSearch() 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("categoryId", "1348");
//        data.put("uniqueCode", "6902088919387");
        data.put("pageNo", "1");
        data.put("pageSize", "20");
//        data.put("brandId", "23423");
//        data.put("appId", "1784");
        data.put("appName", "千里马_打单");
        data.put("businessIdentity", "JOS");
        data.put("ip", "127.0.0.1");
        data.put("userAgent", "golang");
//        data.put("spuId", "12344");
//        data.put("key", "32");
//        data.put("value", "1");
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDCspuSearch, data);
    }

三、返回结果

{
    "total": "100",
    "data": [{
        "---": {
            "features": [{
                "---": {
                    "value": "1",
                    "key": "32"
                }
            }],
            "cspuName": "超威电热蚊香液家用插电式驱蚊液体补充装非无味婴儿孕妇电蚊香液 通用器",
            "saleAttr": "json数据",
            "cspuId": "123123",
            "spuId": "12333"
        }
    }],
    "pageNo": "1",
    "pageSize": "20"
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

四、返回字段说明

名称	类型	示例值	描述
obj	com.jd.gms.spu.api.response.Page	分页信息对象	分页信息对象
- total	Number	100	总条数
- data	java.util.List<com.jd.gms.spu.api.domain.Spu>	标品数据	标品数据
— spuId	Number	12333	父级标品ID
— cspuId	Number	123123	标品ID
— cspuName	String	标品名称示例	标品名称
— saleAttr	String (json数据)	标品属性示例	标品属性
— features	java.util.Set<com.jd.gms.spu.api.domain.Feature>	特殊属性	特殊属性
—— key	String	32	特殊属性key
—— value	String	1	特殊属性value
pageNo	Number	1	页号
pageSize	Number	20	页码