获取单个商品
1.请求参数:
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 京东的账号，对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - wareId | Number | 是 | 1 | 商品id |
| - field | String | 否 | 例如 itemNum，barCode | 可选的返回的字段 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void findWareById() 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", "10022660724067");
String fields = "wareId,title,categoryId,brandId,templateId,transportId,wareStatus,outerId,itemNum,barCode,wareLocation,modified,created,offlineTime,onlineTime,colType,delivery,adWords,wrap,packListing,weight,width,height,length,props,features,images,shopCategorys,mobileDesc,introduction,zhuangBaIntroduction,zhuangBaId,introductionUseFlag,afterSales,logo,marketPrice,costPrice,jdPrice,brandName,stockNum,categorySecId,shopId,promiseId,multiCategoryId,multiCateProps,sellPoint,wareTax,afterSaleDesc,zhuangBaMobileDesc,mobileZhuangBaId,mobileDescUseFlag,fitCaseHtmlPc,fitCaseHtmlApp,specialServices,parentId,wareGroupId,businessType,designConcept,isArchival,templateIds,spuId";
data.put("field",fields );
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDfindWareById, data);
}
3. 返回结果如下：
返回结果
{
"code": 0,
"message": "ok",
"data": {
"data": {
"extendInfoList": [
{
"key": "promiseTemplateType",
"value": "0"
},
{
"key": "globalMark",
"value": "{fwsc_shop_createspu=false, isKeyAccountEvoquePrice=false, hxjfw_new=false, isAgreementPriceVendor=false}"
}
],
"material": {
"mainImages": [
{
"imageInfoList": [
{
"colorId": "0000000000",
"gptFlag": false,
"imgId": "698324445776",
"imgUrl": "jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg",
"orderSort": 1,
"primaryFlag": true
}
],
"uuid": "0000000000"
},
{
"imageInfoList": [
{
"colorId": "94603877509",
"gptFlag": false,
"imgId": "698324445777",
"imgUrl": "jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg",
"orderSort": 1,
"primaryFlag": true
}
],
"uuid": "94603877509"
},
{
"imageInfoList": [
{
"colorId": "98655088507",
"gptFlag": false,
"imgId": "713923040988",
"imgUrl": "jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg",
"orderSort": 1,
"primaryFlag": true
}
],
"uuid": "98655088507"
}
],
"publishScheduleFlag": false
},
"productInfo": {
"afterServiceInfo": {},
"brandInfo": {
"brandName": ""
},
"categoryDetail": {
"lastCategoryId": 31822,
"thirdCategoryId": 6911
},
"colType": 0,
"createdTime": 1782734193000,
"features": [
{
"key": "is7ToReturn",
"value": "9"
},
{
"key": "wlzyc",
"value": "29|26|31|30|11|28"
},
{
"key": "zyyfmb",
"value": "1"
},
{
"key": "mobileDescUseFlag",
"value": "0"
},
{
"key": "scsj",
"value": "1782734186813"
},
{
"key": "descModel",
"value": "1"
},
{
"key": "fply",
"value": "shop-pc"
},
{
"key": "deliveryTimeType",
"value": "1"
},
{
"key": "salemodel",
"value": "POP_MODEL"
},
{
"key": "isPayFirst",
"value": "1"
},
{
"key": "introductionUseFlag",
"value": "0"
}
],
"gaeaProductFlag": false,
"height": 0,
"itemNum": "",
"kaFlag": false,
"length": 0,
"logisticsInfo": {
"packSpecification": 0,
"promiseId": 8126830309,
"transportId": 1118323398
},
"modifiedTime": 1789450518000,
"priceInfo": {
"costPrice": 0,
"jdPrice": 2
},
"productDetailDesc": {
"desc": "\u003cimg class=\"shop-editor-floor 10efe2f3-1349-450e-9dee-6e657acd9d0c\" floor-id=\"10efe2f3-1349-450e-9dee-6e657acd9d0c\" src=\"https://img10.360buyimg.com/img/jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg\" style=\"max-width:100%\"/\u003e",
"mobileDesc": "\u003cimg class=\"shop-editor-floor 10efe2f3-1349-450e-9dee-6e657acd9d0c\" floor-id=\"10efe2f3-1349-450e-9dee-6e657acd9d0c\" src=\"https://img10.360buyimg.com/img/jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg\" style=\"max-width:100%\"/\u003e",
"mobileZhuangBaUseFlag": false,
"zhuangBaUseFlag": "0"
},
"productId": 10035324192622,
"productName": "椰子厚底防滑凉拖鞋",
"productStatus": {
"productStatus": 2,
"productStatusNew": 105,
"yn": 1
},
"productTitle": {
"title": "椰子厚底防滑凉拖鞋",
"titleBrandName": ""
},
"snFlag": false,
"to7ReturnFlag": false,
"upcCode": "",
"wareLocation": "",
"wareStatus": 2,
"width": 0
},
"skuList": [
{
"createdTime": 1787303931000,
"currencySpuId": 0,
"imgTag": 0,
"logistics": {
"promiseId": 0
},
"logo": "jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg",
"modifiedTime": 1789446556000,
"outerId": "",
"priceInfo": {
"jdPrice": 1
},
"productId": 10035324192622,
"saleAttrTemplateId": "POP_MODEL",
"saleAttrs": [
{
"attrId": "1000000062",
"attrName": "颜色",
"attrValueAlias": "乳白色",
"attrValues": "98655088507",
"attrValuesSeqNo": 2,
"dim": 1,
"indexId": 1,
"mappingId": "",
"templateSkuProps": [
{
"id": 4631,
"value": "乳白色",
"valueId": 1114739
}
]
}
],
"skuEnableStatus": 1,
"skuId": 10233243055990,
"skuName": "椰子厚底防滑凉拖鞋 乳白色",
"skuStatus": {
"onOffShelfStatus": 2,
"onShelfTime": 1788242074000
},
"stockNum": 4,
"upcCode": "",
"uuid": "10233243055990",
"valid": 1
},
{
"createdTime": 1782734193000,
"currencySpuId": 0,
"features": [
{
"key": "xxhf",
"value": "1"
},
{
"key": "bcdsjsp",
"value": "1"
}
],
"imgTag": 0,
"logistics": {
"promiseId": 0
},
"logo": "jfs/t1/462648/40/14457/26806/6a425d42Fc4d486fb/0083320320a4b3c8.jpg",
"modifiedTime": 1789446556000,
"outerId": "",
"priceInfo": {
"jdPrice": 2
},
"productId": 10035324192622,
"saleAttrTemplateId": "POP_MODEL",
"saleAttrs": [
{
"attrId": "1000000062",
"attrName": "颜色",
"attrValueAlias": "白色+黑色+浅绿色",
"attrValues": "94603877509",
"attrValuesSeqNo": 1,
"dim": 1,
"indexId": 1,
"mappingId": "",
"templateSkuProps": [
{
"id": 4631,
"value": "白色+黑色+浅绿色"
}
]
}
],
"skuEnableStatus": 1,
"skuId": 10227830152861,
"skuName": "椰子厚底防滑凉拖鞋 白色+黑色+浅绿色",
"skuStatus": {
"onOffShelfStatus": 2,
"onShelfTime": 1788242074000
},
"stockNum": 4,
"upcCode": "",
"uuid": "10227830152861",
"valid": 1
}
]
},
"success": true
},
"trace_id": "722b3013-8977-4c17-bc21-4c49d13227c0"
}
京东图片前缀地址为：https://img12.360buyimg.com/n5
说明： code为0表示成功，非0为失败，message会包含失败原因。返回字段说明 https://open.jd.com/v2/#/doc/api?apiCateId=48&apiId=1223&apiName=jingdong.sku.read.findSkuById&gwType=0
文档更新时间: 2026-09-15 17:15 作者：admin
