京东SKU搜索服务
通过skuId,上下架状态，库存数量，等维度的信息，检索sku列表信息。适用于管理端通过条件检索sku列表场景
1.请求参数:
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 京东的账号，对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - wareId | Number | 是 | 10026288980564 | 商品Id |
| - field | String | 是 | 如: categoryId、stockNum、skuName | 自定义返回字段 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void JDSearchSkuList() 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("wareId", "10026288980564");
String fields = "wareId,skuId,status,saleAttrs,features,jdPrice,outerId,barCode,categoryId,imgTag,logo,skuName,stockNum,wareTitle,fixedDeliveryTime,relativeDeliveryTime,parentId,modified,multiCateProps,capacity,promiseId,saleAttrTemplateId,enable,currencySpuId";
data.put("field",fields);
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDSearchSkuList, data);
}3. 返回结果如下：
{
"code": 0,
"message": "ok",
"data": {
"code": "0",
"page": {
"data": [
{
"barCode": "",
"categoryId": 1355,
"enable": 1,
"features": [
{
"featureKey": "shortTitle",
"featureValue": "测试品牌1夏季女士T恤衫0802-1"
},
{
"featureKey": "slpbsp",
"featureValue": "1"
}
],
"imgTag": 0,
"jdPrice": 150,
"logo": "jfs/t1/288528/17/2550/85951/681888efFd6cf34d8/7a1836478a5a5dec.jpg",
"modified": 1742796513000,
"multiCateProps": [],
"outerId": "88",
"saleAttrTemplateId": "POP_MODEL",
"saleAttrs": [
{
"attrId": "1000000044",
"attrValueAlias": [
[
{
"valueId": "1116289",
"id": 4925,
"value": "3XL"
}
]
],
"attrValues": [
"1116289"
],
"attrValuesSeqNo": [
2
],
"index": 2
},
{
"attrId": "1000000033",
"attrValueAlias": [
[
{
"valueId": "1113810",
"id": 4923,
"value": "炭灰色"
}
]
],
"attrValues": [
"1113810"
],
"attrValuesSeqNo": [
2
],
"index": 1
}
],
"skuId": 10111522355888,
"skuName": "测试品牌1夏季女士T恤衫0802-1 炭灰色 3XL",
"status": 1,
"stockNum": 0,
"wareId": 10026288980564,
"wareTitle": "测试品牌1夏季女士T恤衫0802-1"
},
{
"barCode": "",
"categoryId": 1355,
"enable": 1,
"features": [
{
"featureKey": "shortTitle",
"featureValue": "测试品牌1夏季女士T恤衫0802-1"
},
{
"featureKey": "slpbsp",
"featureValue": "1"
}
],
"imgTag": 0,
"jdPrice": 150,
"logo": "jfs/t1/301688/13/2738/32666/681888eaF076a92da/9a588d1b1c1de1fb.jpg",
"modified": 1742796513000,
"multiCateProps": [],
"outerId": "23",
"saleAttrTemplateId": "POP_MODEL",
"saleAttrs": [
{
"attrId": "1000000033",
"attrValueAlias": [
[
{
"valueId": "1113806",
"id": 4923,
"value": "灰色"
}
]
],
"attrValues": [
"1113806"
],
"attrValuesSeqNo": [
1
],
"index": 1
},
{
"attrId": "1000000044",
"attrValueAlias": [
[
{
"valueId": "1116288",
"id": 4925,
"value": "2XL"
}
]
],
"attrValues": [
"1116288"
],
"attrValuesSeqNo": [
1
],
"index": 2
}
],
"skuId": 10111522355885,
"skuName": "测试品牌1夏季女士T恤衫0802-1 灰色 2XL",
"status": 1,
"stockNum": 0,
"wareId": 10026288980564,
"wareTitle": "测试品牌1夏季女士T恤衫0802-1"
},
{
"barCode": "",
"categoryId": 1355,
"enable": 1,
"features": [
{
"featureKey": "shortTitle",
"featureValue": "测试品牌1夏季女士T恤衫0802-1"
},
{
"featureKey": "slpbsp",
"featureValue": "1"
}
],
"imgTag": 0,
"jdPrice": 150,
"logo": "jfs/t1/301688/13/2738/32666/681888eaF076a92da/9a588d1b1c1de1fb.jpg",
"modified": 1742796513000,
"multiCateProps": [],
"outerId": "57",
"saleAttrTemplateId": "POP_MODEL",
"saleAttrs": [
{
"attrId": "1000000033",
"attrValueAlias": [
[
{
"valueId": "1113806",
"id": 4923,
"value": "灰色"
}
]
],
"attrValues": [
"1113806"
],
"attrValuesSeqNo": [
1
],
"index": 1
},
{
"attrId": "1000000044",
"attrValueAlias": [
[
{
"valueId": "1116289",
"id": 4925,
"value": "3XL"
}
]
],
"attrValues": [
"1116289"
],
"attrValuesSeqNo": [
2
],
"index": 2
}
],
"skuId": 10111522355886,
"skuName": "测试品牌1夏季女士T恤衫0802-1 灰色 3XL",
"status": 1,
"stockNum": 0,
"wareId": 10026288980564,
"wareTitle": "测试品牌1夏季女士T恤衫0802-1"
},
{
"barCode": "",
"categoryId": 1355,
"enable": 1,
"features": [
{
"featureKey": "shortTitle",
"featureValue": "测试品牌1夏季女士T恤衫0802-1"
},
{
"featureKey": "slpbsp",
"featureValue": "1"
}
],
"imgTag": 0,
"jdPrice": 150,
"logo": "jfs/t1/288528/17/2550/85951/681888efFd6cf34d8/7a1836478a5a5dec.jpg",
"modified": 1742796513000,
"multiCateProps": [],
"outerId": "44",
"saleAttrTemplateId": "POP_MODEL",
"saleAttrs": [
{
"attrId": "1000000033",
"attrValueAlias": [
[
{
"valueId": "1113810",
"id": 4923,
"value": "炭灰色"
}
]
],
"attrValues": [
"1113810"
],
"attrValuesSeqNo": [
2
],
"index": 1
},
{
"attrId": "1000000044",
"attrValueAlias": [
[
{
"valueId": "1116288",
"id": 4925,
"value": "2XL"
}
]
],
"attrValues": [
"1116288"
],
"attrValuesSeqNo": [
1
],
"index": 2
}
],
"skuId": 10111522355887,
"skuName": "测试品牌1夏季女士T恤衫0802-1 炭灰色 2XL",
"status": 1,
"stockNum": 0,
"wareId": 10026288980564,
"wareTitle": "测试品牌1夏季女士T恤衫0802-1"
}
],
"pageNo": 1,
"pageSize": 20,
"totalItem": 4
},
"request_id": "8cb1268a52d144059573600eecb10d09"
}
}
说明： code为0表示成功，非0为失败，message会包含失败原因。 返回字段说明文档，https://open.jd.com/v2/#/doc/api?apiCateId=48&apiId=1227&apiName=jingdong.sku.read.searchSkuList&gwType=0
文档更新时间: 2025-06-13 13:36 作者：admin
