获取单个商品

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/ware/findwarebyid

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
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