标品搜索,传入条件大部分是非必填
使用类目、品牌等条件搜索标品,传入条件大部分是非必填
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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组 |
2. 请求示例代码(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);
}
3. 返回结果如下:
{
"total": "100",
"data": [{
"---": {
"features": [{
"---": {
"value": "1",
"key": "32"
}
}],
"cspuName": "超威电热蚊香液家用插电式驱蚊液体补充装非无味婴儿孕妇电蚊香液 通用器",
"saleAttr": "json数据",
"cspuId": "123123",
"spuId": "12333"
}
}],
"pageNo": "1",
"pageSize": "20"
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4. 返回字段说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 | 页码 |
文档更新时间: 2024-06-28 16:37 作者:JSL