获取单个商品
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");
data.put("field","wareId,title,categoryId,brandId,wareStatus,outerId,itemNum,barCode,wareLocation,modified,created,logo,images" );
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDfindWareById, data);
}
3. 返回结果如下:
返回结果
{
"code": 0,
"message": "ok",
"data": {
"brandId": 362679,
"categoryId": 11222,
"colType": 0,
"created": 1653938314000,
"itemNum": "rjMX8wWW",
"logo": "jfs/t1/55102/16/18472/99056/6291471aEae12ff31/886dab8270b0fb86.jpg",
"modified": 1657201041000,
"multiCategoryId": 11222,
"offlineTime": 1657201042000,
"onlineTime": 1653939561000,
"title": "依迪筱 男童篮球服休闲风短袖套装背心夏装2022新款帅气男孩夏季中大童儿童洋气",
"wareId": 10022660724067,
"wareLocation": 1,
"wareStatus": -1
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
京东图片前缀地址为:https://img12.360buyimg.com/n5
4. 返回字段说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ware | com.jd.pop.ware.ic.api.domain.Ware | 商品数据对象 | |
- wareId | Number | 1 | 商品id |
- title | String | 商品名称 | 商品名称 |
- categoryId | Number | 655 | 3级类目ID |
- brandId | Number | 11115 | 品牌ID |
- templateId | Number | 1111221111 | 关联板式id |
- transportId | Number | 11111 | 运费模板ID |
- wareStatus | Number | 1 | 商品状态-1:删除 1:从未上架 2:自主下架 4:系统下架 8:上架 513:从未上架待审 514:自主下架待审 516:系统下架待审 520:上架待审核 1028:系统下架审核失败 |
- outerId | String | fggh | 外部ID |
- itemNum | String | 111 | 商品货号 |
- barCode | String | 11111 | 条形码 |
- wareLocation | Number | 1 | 商品产地 |
- modified | Date | 2019-01-01 01:01:01 | 商品最后一次修改时间,只读属性 |
- created | Date | 2019-01-01 01:01:01 | 商品创建时间,只读属性 |
- offlineTime | Date | 2019-01-01 01:01:01 | 最后下架时间,只读属性 |
- onlineTime | Date | 2019-01-01 01:01:01 | 最后上架时间,只读属性 |
- colType | Number | 1 | 合作模式 |
- delivery | String | 发货地 | 发货地 |
adWords | com.jd.pop.ware.ic.api.domain.AdWords | 商品广告词 | |
- words | String | 广告词仅文字内容 | 广告词仅文字内容 |
- url | String | 广告词链接地址 | 广告词链接地址 |
- urlWords | String | 广告词链接文案 | 广告词链接文案 |
- wrap | String | 包装规格 | 包装规格 |
- packListing | String | 包装清单 | 包装清单 |
- weight | Number | 1 | 重 |
- width | Number | 1 | 宽 |
- height | Number | 1 | 高度 |
- length | Number | 1 | 长 |
props | java.util.Set | 属性列表(已废弃 请使用multiCateProps) | |
— | com.jd.pop.ware.ic.api.domain.Prop | ||
- attrId | String | attrId | 属性ID |
- attrValueAlias | String[] | attrValueAlias | 属性值的描述或者别名 |
- attrValues | String[] | attrValues | 属性值ID集合 |
features | java.util.Set | 特殊属性集合 | |
— | com.jd.pop.ware.ic.api.domain.Feature | ||
- featureCn | String | featureCn | 可不填 |
- featureKey | String | featureKey | 特殊属性key |
- featureValue | String | featureValue | 特殊属性value |
images | java.util.List | 商品图片 | |
— | com.jd.pop.ware.ic.api.domain.Image | ||
- colorId | String | colorId | 颜色id,颜色id和您设置的销售属性值id对应,使用接口jingdong.category.read.findValuesByAttrIdUnlimit 获取 ,如果没销售属性,则默认为10个0(主图,并且主图必填) |
- imgId | Number | 1 | 图片ID |
- imgIndex | Number | 1 | 图片顺序 |
- imgUrl | String | 京东图片服务器地址,不包括前缀。例如:jfs/t2116/102/1731643157/81969/c3df941a/5670f868Nc441d4c3.jpg | 京东图片服务器地址,不包括前缀。例如:jfs/t2116/102/1731643157/81969/c3df941a/5670f868Nc441d4c3.jpg |
- imgZoneId | String | imgZoneId | 图片空间中图片ID |
shopCategorys | java.util.Set | 商品店内分类(商家接口获取到的最末级的分类) | |
- — | Number | 1 | |
- mobileDesc | String | 移动端详情 | 移动端详情 |
- introduction | String | PC端详情 | PC端详情 |
- zhuangBaIntroduction | String | 装吧详情 | 装吧详情 |
- zhuangBaId | String | 商品描述装吧实例ID | 商品描述装吧实例ID |
- introductionUseFlag | String | 0或者1 | 商品描述使用标识 ,0:使用默认的商品描述,1:使用装吧商详 |
- afterSales | String | 售后服务 | 售后服务 |
- logo | String | 商品主图 | 商品主图 |
- marketPrice | Number | 1 | 市场价 |
- costPrice | Number | 1 | 成本价 |
- jdPrice | Number | 1 | 京东价 |
- brandName | String | 品牌名称 | 品牌名称 |
- stockNum | Number | 1 | 总库存数 |
- categorySecId | Number | 1 | 二级叶子类目,只读属性 |
- shopId | Number | 1 | 商家对应的shopID,只读属性 |
- promiseId | Number | 1 | 时效模板ID |
- multiCategoryId | Number | 1 | 末级类目ID |
multiCateProps | java.util.Set | 末级类目属性列表 | |
— | com.jd.pop.ware.ic.api.domain.Prop | ||
- attrId | String | attrId | 属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 按照4级类目获取 |
- attrValues | String | attrValues | 属性值ID数组 jingdong.category.read.findValuesByAttrIdUnlimit 获取,输入方式类型请填写文字 |
- expands | String | expands | 属性值扩展字段 |
- units | String | units | 属性值单位 |
- sellPoint | String | 卖点 | 卖点 |
wareTax | com.jd.pop.ware.ic.api.domain.WareTax | 税率 | |
- taxCode | String | taxCode | 税收编码(固定长度19位) |
- taxRate | Number | 1 | 税率 |
- isTaxCheap | Number | 1 | 是否享受税收优惠政策(0:不享受;1:享受;) |
- taxCheapContent | String | taxCheapContent | 享受税收优惠政策内容(最大长度32位) |
- zeroTaxRate | Number | 1 | 零税率(0:出口退税;1:免税;2:不征收;3:普通零税率;) |
- afterSaleDesc | String | 售后图文详情 | 售后图文详情 |
- zhuangBaMobileDesc | String | 移动版装吧商详 | 移动版装吧商详 |
- mobileZhuangBaId | String | 移动版装吧实例ID | 移动版装吧实例ID |
- mobileDescUseFlag | String | 0或者1 | 移动版商品描述使用标识,0:使用默认的移动商详;1:使用装吧移动版商详 |
- fitCaseHtmlPc | String | 装修案例PC版描述 | 装修案例PC版描述 |
- fitCaseHtmlApp | String | 装修案例移动版描述 | 装修案例移动版描述 |
specialServices | java.util.List | 特色服务,装修类目才可填写,装修类必填,最大为5,每个值最长为8个字符 | |
- — | String | 特色服务 | |
- parentId | Number | 1 | 商品父ID(供销商品)普通商品没有 |
- wareGroupId | Number | 1 | 商品门店组ID(供销商品)普通商品没有 |
- businessType | String | 商品业务类型 | 商品业务类型(供销商品)普通商品没有 |
- designConcept | String | 商品设计理念 | 商品设计理念,适用范围是toplife类目 |
- isArchival | Boolean | true | 是否归档商品(归档商品不能进行修改) |
- templateIds | String | 新版关联版式Id | 新版关联版式Id |
文档更新时间: 2024-06-28 16:37 作者:admin