获取单个商品
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": {
"adWords": {
"url": "",
"urlWords": "",
"words": "测试品牌（0506-2）宝贝发布0802（多组属性）"
},
"afterSales": "1年",
"barCode": "",
"brandId": 955844,
"brandName": "测试品牌（0506-2）",
"categoryId": 1355,
"categorySecId": 0,
"colType": 0,
"costPrice": 0,
"created": 1722566191000,
"delivery": 579,
"features": [
{
"featureKey": "scsj",
"featureValue": "1722566184697"
},
{
"featureKey": "zyyfmb",
"featureValue": "1"
},
{
"featureKey": "isTest",
"featureValue": "1"
},
{
"featureKey": "noShow",
"featureValue": "1"
},
{
"featureKey": "salemodel",
"featureValue": "POP_MODEL"
},
{
"featureKey": "deliveryTimeType",
"featureValue": "1"
},
{
"featureKey": "fply",
"featureValue": "jospop-D03BE7C08B87C14BECBFF613ABBDB58E"
},
{
"featureKey": "SoldOversea",
"featureValue": "7"
},
{
"featureKey": "is7ToReturn",
"featureValue": "1"
},
{
"featureKey": "wlzyc",
"featureValue": "1"
}
],
"height": 77,
"images": [
{
"colorId": "0000000000",
"imgId": 350940216515,
"imgIndex": 1,
"imgUrl": "jfs/t1/298416/5/3366/55514/681888e8F6c0619c3/5c63b1c6e2393d3b.jpg"
},
{
"colorId": "0000000000",
"imgId": 350940216516,
"imgIndex": 2,
"imgUrl": "jfs/t1/56084/24/25496/211935/66ac41cfF1cb60abc/f5a7b949c46348dc.jpg"
}
],
"introduction": "<div><b><font color=\"#0000cc\">12</font></b></div><div><b><font color=\"#0000cc\">15645646<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/108457/10/39502/211935/66aca2f2F3e88f251/2cfcde50b3a6be23.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/57675/23/24553/13762/66aca2f3F11997948/be1b871512ec8567.png\"><br></font></b></div><div><b><font color=\"#990033\">456546<br></font></b></div><div><b><font color=\"#006666\"><i>中华人民共和国<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/83290/22/27318/205218/66ac41caF0e810e7f/594d34928e9e196e.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/40019/28/23128/733662/66ac41cbF60dc24d6/1622f5e3bbdefe82.jpg\" class=\"\" width=\"200\" height=\"200\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/23809/28/20901/13082/66ac41ccF6a976a0f/6ed74d5e6c952b17.png\"><br><br><br></i></font></b></div>",
"itemNum": "sjbm0802",
"jdPrice": 150,
"length": 12,
"logo": "jfs/t1/298416/5/3366/55514/681888e8F6c0619c3/5c63b1c6e2393d3b.jpg",
"marketPrice": 181,
"mobileDesc": "<div><b><font color=\"#0000cc\">12</font></b></div><div><b><font color=\"#0000cc\">15645646<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/108457/10/39502/211935/66aca2f2F3e88f251/2cfcde50b3a6be23.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/57675/23/24553/13762/66aca2f3F11997948/be1b871512ec8567.png\"><br></font></b></div><div><b><font color=\"#990033\">456546<br></font></b></div><div><b><font color=\"#006666\"><i>中华人民共和国<img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/83290/22/27318/205218/66ac41caF0e810e7f/594d34928e9e196e.jpg\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/40019/28/23128/733662/66ac41cbF60dc24d6/1622f5e3bbdefe82.jpg\" class=\"\" width=\"200\" height=\"200\"><br><img src=\"http://img10.360buyimg.com/imgzone/jfs/t1/23809/28/20901/13082/66ac41ccF6a976a0f/6ed74d5e6c952b17.png\"><br><br><br></i></font></b></div>",
"modified": 1749156585000,
"multiCateProps": [
{
"attrId": "118771",
"attrValueAlias": [
"18-24周岁",
"25-29周岁",
"30-34周岁",
"35-39周岁",
"40-49周岁",
"17周岁以下"
],
"attrValues": [
"638004",
"638005",
"638006",
"638007",
"638008",
"638009"
],
"expands": [
"",
"",
"",
"",
"",
""
],
"units": [
"",
"",
"",
"",
"",
""
]
},
{
"attrId": "19946",
"attrValueAlias": [
"修身型"
],
"attrValues": [
"294360"
],
"expands": [
""
],
"units": [
""
]
},
{
"attrId": "118770",
"attrValueAlias": [
"甜美风"
],
"attrValues": [
"1070263"
],
"expands": [
""
],
"units": [
""
]
},
{
"attrId": "9772",
"attrValueAlias": [
"棉",
"竹纤维",
"粘纤(粘胶纤维)",
"醋纤(醋酯纤维)",
"莫代尔",
"涤纶(聚酯纤维)",
"桑蚕丝",
"铜氨纤维",
"氨纶(聚氨酯弹性纤维)",
"丙纶(聚丙烯纤维)",
"锦纶/尼龙(聚酰胺纤维)",
"金属纤维",
"聚酯复合弹性纤维",
"黄麻(黄麻及同类纤维)",
"牛毛纤维",
"聚酯薄膜纤维",
"牦牛毛",
"碳纤维",
"PU(聚氨酯)",
"其他",
"大豆蛋白纤维(大豆纤维)",
"大麻(汉麻/火麻)",
"弹性纤维",
"金属镀膜纤维",
"腈纶(聚丙烯腈纤维)",
"莱赛尔",
"木棉",
"三醋酯纤维",
"山羊绒",
"头层牛皮",
"兔毛",
"亚麻",
"羊毛",
"再生纤维素纤维",
"柞蚕丝",
"苎麻",
"羊皮革"
],
"attrValues": [
"709842",
"664114",
"709845",
"709846",
"165653",
"709847",
"709856",
"1445017",
"709860",
"709861",
"709862",
"1445328",
"1445446",
"1445759",
"1445824",
"1445859",
"1429408",
"1445918",
"742653",
"987048",
"742658",
"742659",
"742661",
"742666",
"742668",
"742673",
"742683",
"742686",
"742688",
"742692",
"742693",
"742695",
"742696",
"742699",
"742700",
"742702",
"1592001"
],
"expands": [
"1",
"1",
"1",
"1",
"1"
],
"units": [
"%"
]
},
{
"attrId": "174076",
"attrValueAlias": [
"棉布",
"棉混纺",
"牛奶丝",
"罗纹布",
"混纺",
"摇粒绒",
"雪纺",
"铜氨丝",
"天鹅绒",
"丝绸",
"乔其纱",
"欧根纱",
"牛仔布",
"牛津纺",
"尼丝纺",
"金丝绒",
"涤塔夫",
"灯芯绒",
"LYCRA莱卡"
],
"attrValues": [
"1459496",
"1489138",
"1588990",
"1588991",
"1459497",
"882562",
"882572",
"882589",
"882600",
"882607",
"882615",
"882622",
"882630",
"882636",
"882641",
"882645",
"882653",
"882656",
"882659"
],
"expands": [
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"units": [
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
""
]
},
{
"attrId": "19957",
"attrValueAlias": [
"荡领"
],
"attrValues": [
"1519636"
],
"expands": [
""
],
"units": [
""
]
},
{
"attrId": "19952",
"attrValueAlias": [
"短款"
],
"attrValues": [
"1006142"
],
"expands": [
""
],
"units": [
""
]
},
{
"attrId": "83110",
"attrValueAlias": [
"2024年秋季"
],
"attrValues": [
"1365069"
],
"expands": [
""
],
"units": [
""
]
},
{
"attrId": "83118",
"attrValueAlias": [
"露肩",
"3D"
],
"attrValues": [
"498297",
"638044"
],
"expands": [
"",
""
],
"units": [
"",
""
]
},
{
"attrId": "118775",
"attrValueAlias": [
"圆点",
"爱心",
"蝴蝶结",
"纯色",
"格子",
"渐变",
"豹纹",
"斑马纹",
"条纹",
"脸谱",
"人物",
"风景",
"碎花",
"骷髅",
"大花",
"建筑",
"游戏",
"动物",
"迷彩",
"文字",
"数字",
"字母",
"千鸟格",
"宇宙星空",
"植物花卉",
"卡通动漫",
"手绘",
"几何图案",
"科技科幻",
"LOGO",
"抽象图案",
"中国文化",
"搞怪",
"运动",
"创意趣味"
],
"attrValues": [
"710049",
"1501231",
"1506555",
"638083",
"709921",
"742705",
"709922",
"709923",
"742708",
"709926",
"638092",
"709927",
"638093",
"709928",
"638094",
"709929",
"638100",
"709920",
"638101",
"638102",
"638104",
"638105",
"638108",
"638110",
"638111",
"638114",
"638116",
"638120",
"638122",
"638124",
"638127",
"638130",
"638134",
"638136",
"638138"
],
"expands": [
],
"units": [
"",
]
},
{
"attrId": "9780",
"attrValueAlias": [
"公主袖"
],
"attrValues": [
"165874"
],
"expands": [
""
],
"units": [
""
]
}
],
"multiCategoryId": 1355,
"offlineTime": 1733311601000,
"onlineTime": 1733890832000,
"outerId": "454",
"packListing": "纽扣x3",
"promiseId": 30528550,
"shopCategorys": [],
"shopId": 617857,
"spuId": 0,
"stockNum": 0,
"templateId": 0,
"title": "测试品牌1夏季女士T恤衫0802-1",
"transportId": 2593375,
"wareId": 10026288980564,
"wareLocation": 2,
"wareStatus": 8,
"weight": 0.5,
"width": 55,
"wrap": "0"
}
}
京东图片前缀地址为：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
文档更新时间: 2025-06-13 13:39 作者：admin
