获取单个SKU
获取单个SKU
一、请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 京东的账号，对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - skuId | Number | 是 | 1 | skuId |
| - field | String | 否 | 如: categoryId、stockNum、skuName | 自定义返回字段 |
二、请求示例代码
Java
请求示例代码
@Test public void findSkuById() 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("skuId", "10053428467428"); String fields = "wareId,skuId,status,saleAttrs,features,jdPrice,outerId,barCode,categoryId,imgTag,logo,skuName,wareTitle,parentId,created,modified,multiCateProps,enable,promiseId,currencySpuId,weight"; data.put("field",fields);
// 参数签名 data.put("sign", Utils.Sign(data, Config.AppSecret)); doHttpRequest(Config.JDfindSkuById, data); }三、返回结果
{ "code": 0, "message": "ok", "data": { "categoryId": 11222, "jdPrice": 139, "outerId": "", "skuId": 10053428467428, "skuName": "依迪筱 男童篮球服休闲风短袖套装背心夏装2022新款帅气男孩夏季中大童儿童洋气 2205款白色 【收藏优先发货】 160 码建议身高150CM左右", "status": 4, "stockNum": 998, "wareId": 10022660724067 }}说明： code为0表示成功，非0为失败，message会包含失败原因。
四、返回字段说明
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| sku | com.jd.pop.ware.ic.api.domain.Sku | 无 | sku对象 |
| - wareId | Number | 1 | 商品ID |
| - skuId | Number | 1 | skuId |
| - status | Number | 1 | 状态,只读属性. 1:上架 2:下架 4:删除 |
| saleAttrs | java.util.Set | 无 | 销售属性集合 |
| — | com.jd.pop.ware.ic.api.domain.Prop | 无 | |
| - attrId | String | 无 | 属性ID |
| - attrValueAlias | String[] | 无 | 属性值的描述或者别名 |
| - attrValues | String[] | 无 | 属性值ID数组 |
| - index | Number | 1 | 销售属性排序 |
| features | java.util.Set | 无 | 特殊属性集合 |
| — | com.jd.pop.ware.ic.api.domain.Feature | 无 | |
| - featureCn | String | 无 | 特殊属性中文含义 |
| - featureKey | String | 无 | 特殊属性key |
| - featureValue | String | 无 | 特殊属性value |
| - jdPrice | Number | 1 | 京东价 |
| - outerId | String | 无 | 外部ID |
| - barCode | String | 无 | sku条形码 |
| - categoryId | Number | 1 | 3级类目id |
| - imgTag | Number | 1 | 图片标签 |
| - logo | String | 无 | sku颜色的主图 |
| - skuName | String | 无 | sku名称 |
| - stockNum | Number | 1 | 总库存数，仅用于非分区的SOP库存，分区库存需要调用库存查询接口 |
| - wareTitle | String | 无 | 商品名称 |
| - fixedDeliveryTime | String | 无 | 大件商品固定发货时效 格式：订单开始日期,订单结束日期,发货日期,完成发货天数 |
| - relativeDeliveryTime | String | 无 | 大件商品相对发货时效（完成发货天数） |
| - parentId | Number | 1 | 父id |
| - modified | Date | 2019-01-01 01:01:01 | 修改时间 |
| - created | Date | 2019-01-01 01:01:01 | 创建时间 |
| multiCateProps | java.util.Set | 无 | 多级SKU属性 |
| — | com.jd.pop.ware.ic.api.domain.Prop | 无 | |
| - attrValueAlias | String[] | 无 | 值别名 |
| - attrId | String | 无 | 属性ID |
| - attrValues | String[] | 无 | 属性值 |
| - expands | String[] | expands | 属性值扩展字段 |
| - units | String[] | units | 属性值单位 |
| props | java.util.Set | 无 | SKU属性（已废弃） |
| — | com.jd.pop.ware.ic.api.domain.Prop | 无 | |
| - attrValueAlias | String[] | 无 | 值别名 |
| - attrId | String | 无 | 属性ID |
| - attrValues | String[] | 无 | 属性值 |
| - capacity | String | 20L 20T | 容量，在有特殊要求的类目下必填！最多支持6位小数。 |
| - promiseId | Number | 12345678 | 时效运费模板id |