京东SKU搜索服务
通过skuId,上下架状态，库存数量，等维度的信息，检索sku列表信息。适用于管理端通过条件检索sku列表场景
一、请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 京东的账号，对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - wareId | Number | 是 | 10026288980564 | 商品Id |
| - field | String | 是 | 如: categoryId、stockNum、skuName | 自定义返回字段 |
二、请求示例代码
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); }三、返回结果
{ "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