标品搜索接口

通过品牌、类目等条件搜索多规格标品

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/sku/findskubyid

公共参数

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

业务参数

名称 类型 必须 示例值 描述
categoryId Number[] 655 类目ID,来自类目数据,最多传入10个
uniqueCode String[] iphone14 关键属性型号、货号等等,来自商品数据,最多传入10个
pageNo Number 1 页号
pageSize Number 20 页码
brandId Number[] 45455 品牌ID,来自品牌数据,最多传入10个
appName String gms4spu app名称
ip String 192.168.1.1 如果调用方本身是一个代理(比如jos),这里应该传入真正调用来源的ip地址
userAgent String zhangsan 操作人/系统名称
key String[] 32 特殊属性key,最多传入10组
value String[] 1 特殊属性value,最多传入10组

2. 请求示例代码(Java)

请求示例代码

 @Test
    public void     JDSpuSearch() 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", "28288");
        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.JDSpuSearch, data);
    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
        "total": "100",
        "data": [{
            "---": {
                "features": [{
                    "---": {
                        "value": "1",
                        "key": "32"
                    }
                }],
                "spuName": "测试标品名称",
                "spuId": "345345"
            }
        }],
        "pageNo": "1",
        "pageSize": "20"
    }
}

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

4. 返回字段说明

名称 类型 示例值 描述
result com.jd.gms.spu.api.response.Result 返回结果
- success Boolean true 调用是否成功
- errorMessage String 错误信息
- errorCode String 错误码
obj com.jd.gms.spu.api.response.Page 分页信息
- total Number 100 总数
- data java.util.List<com.jd.gms.spu.api.domain.ProductSpu> 标品数据列表
— spuId Number 345345 标品ID
— spuName String 测试标品名称 标品名称
— 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 页码
文档更新时间: 2024-06-28 16:37   作者:JSL