1. 根据三级类目编号查询商品列表

接口名称

jingdong.ware.promotion.search.catelogy.list 

API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
catelogyId  String 
三级类目编号 
page  Number 
页码 
pageSize  Number 
分页大小(范围100)
client  String 
客户端类型
(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad)
非移动应用调取默认设置为m

返回结果

名称 类型 示例值 描述
searchCatelogyList  SearchCatelogyList 

SearchCatelogyList属性

名称 类型 是否必须 示例值 描述
resultCode  Number 
接口返回信息码 
wareCount  Number 
总记录数 
page  Number 
页码 
regionIsTrue  Boolean 
是否可以对地区筛选 
selfIsTrue  Boolean 
是否可以对配送筛选 
show  String 
展示形式 
wareInfo  WareInfo[] 

WareInfo属性

名称 类型 是否必须 示例值 描述
adWord  String 
广告词 
isBook  Boolean 
是否为图书 
canFreeRead  Boolean 
是否免费阅读 
endRemainTime  String 
秒杀离结束时间 
imageUrl  String 
商品图片url 
jdPrice  Number 
京东价 
martPrice  Number 
市场价 
startRemainTime  String 
秒杀离开始时间 
skuId  String 
商品编号 
wareName  String 
商品名称 

返回示例

JSON数据格式

{
  "jingdong_ware_promotion_search_catelogy_list_response":{
  "searchCatelogyList":{
  "page":"",
"resultCode":"",
"regionIsTrue":"",
"wareInfo":[{
  "wareName":"",
"martPrice":"",
"startRemainTime":"",
"imageUrl":"",
"adWord":"",
"skuId":"",
"jdPrice":"",
"endRemainTime":"",
"canFreeRead":"",
"isBook":""
  }],
"show":"",
"selfIsTrue":"",
"wareCount":""
  }
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionSearchCatelogyListRequest request=new WarePromotionSearchCatelogyListRequest();
request.setCatelogyId( "jingdong" );
request.setPage( 123 );
request.setPageSize( 123 );
request.setClient( "jingdong" );
WarePromotionSearchCatelogyListResponse response=client.execute(request);

2. 省会编号查询
接口名称

jingdong.ware.selected.province.list.get

API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
client  String  apple 

客户端类型

(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

非移动应用调取默认设置为m

返回结果

名称 类型 示例值 描述
provinceList  ProvinceList 

属性

名称 类型 是否必须 示例值 描述
resultCode  Number 
接口返回信息码 
provinces  Provice[] 

属性

名称 类型 是否必须 示例值 描述
label  String 

value  String 


返回示例

JSON数据格式

{
  "jingdong_ware_selected_province_list_get_response":{
  "provinceList":{
  "resultCode":"",
"provinces":[{
  "value":"",
"label":""
  }]
  }
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareSelectedProvinceListGetRequest request=new WareSelectedProvinceListGetRequest();
request.setClient( "jingdong" );
WareSelectedProvinceListGetResponse response=client.execute(request);

3. 商品搜索列表
接口名称

jingdong.ware.product.search.list.get

API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
isLoadAverageScore  Boolean  true  是否加载评星,true为加载,false为不加载 
isLoadPromotion  Boolean  true  是否加载促销,true为加载,false为不加载 
sort  Number  1:销量排序 2:价格降序 3:价格升序 4:好评度 6:评论数 
page  Number  页码 
pageSize  Number  10  分页大小 
keyword  String  电饭锅  关键词 
client  String  apple 

客户端类型

(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

非移动应用调取默认设置为m

返回结果

名称 类型 示例值 描述
searchProductList  SearchProductList 

SearchProductList属性

名称 类型 是否必须 示例值 描述
resultCode  Number 
接口返回信息码 
wareCount  Number 
总记录数 
page  Number 

wareInfo  WareInfo[] 

WareInfo属性

名称 类型 是否必须 示例值 描述
adWord  String 
广告词 
isBook  Boolean 
是否为图书 
canFreeRead  Boolean 
是否免费阅读 
endRemainTime  String 
秒杀离结束时间 
imageUrl  String 
商品图片url 
jdPrice  Number 
京东价 
martPrice  Number 
市场价 
startRemainTime  String 
秒杀离开始时间 
skuId  String 
商品编号 
wareName  String 
商品名称 

返回示例

JSON数据格式

{
  "jingdong_ware_product_search_list_get_response":{
  "searchProductList":{
  "page":"",
"resultCode":"",
"wareInfo":[{
  "wareName":"",
"martPrice":"",
"startRemainTime":"",
"imageUrl":"",
"adWord":"",
"skuId":"",
"jdPrice":"",
"endRemainTime":"",
"canFreeRead":"",
"isBook":"",
"markerPrice":""
  }],
"wareCount":""
  }
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareProductSearchListGetRequest request=new WareProductSearchListGetRequest();
request.setIsLoadAverageScore( true );
request.setIsLoadPromotion( true );
request.setSort( 123 );
request.setPage( 123 );
request.setPageSize( 123 );
request.setKeyword( "jingdong" );
request.setClient( "jingdong" );
WareProductSearchListGetResponse response=client.execute(request);

4. 获取库存信息列表
接口名称

jingdong.ware.product.stock.list.get

API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
skuId  Number  967403  商品编号 
provinceId  Number  省份编号 
client  String  m

客户端类型

默认设置为 m

返回结果

名称 类型 示例值 描述
productStock  ProductStock 

ProductStock属性

名称 类型 是否必须 示例值 描述
resultCode  Number 
接口返回信息码 
flag  Boolean 
是否有货 
stockStatus  String 
库存状态 

返回示例

JSON数据格式


{
  "jingdong_ware_product_stock_list_get_response":{
  "productStock":{
  "flag":"",
"stockStatus":"",
"resultCode":""
  }
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareProductStockListGetRequest request=new WareProductStockListGetRequest();
request.setSkuId( 123 );
request.setProvinceId( 123 );
request.setClient( "jingdong" );
WareProductStockListGetResponse response=client.execute(request);

5. 获取商品SKU信息列表
接口名称

jingdong.ware.sku.search.list.get

API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
skuId  Number  967403  商品编号 
client  String  apple 

客户端类型

(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad)

非移动应用调取默认设置为m

返回结果

名称 类型 示例值 描述
productSkuList  ProductSkuList 

ProductSkuList 属性

名称 类型 是否必须 示例值 描述
resultCode  Number 
接口返回信息码 
skuColor  List 

skuSize  SkuSize[] 

skuColor  SkuColor[] 

SkuSize属性

名称 类型 是否必须 示例值 描述
secKill  Boolean 
是否是秒杀商品 
description  String 
描述 
promotion  Boolean 
是否促销 
directShow  Boolean 
是否直接展示 
canFreeRead  Boolean 
是否能免费阅读 
showMartPrice  Boolean 
是否展示市场价 
skuId  Number 
商品编号 
size  String 
尺寸 

SkuColor属性

名称 类型 是否必须 示例值 描述
colorImg  String 
颜色URL 
waretitle  String 
广告词 
wname  String 
商品名称 
color  String 
颜色 
secKill  Boolean 
是否是秒杀商品 
description  String 
描述 
promotion  Boolean 
是否促销 
directShow  Boolean 
是否直接展示 
canFreeRead  Boolean 
是否能免费阅读 
showMartPrice  Boolean 
是否展示市场价 
skuId  Number 
商品编号 
size  String 
尺寸 

返回示例

JSON数据格式


{
  "jingdong_ware_sku_search_list_get_response":{
  "productSkuList":{
  "skuSize":[{
  "description":"",
"promotion":"",
"skuId":"",
"secKill":"",
"directShow":"",
"showMartPrice":"",
"canFreeRead":"",
"size":""
  }],
"skuColor":[{
  "waretitle":"",
"colorImg":"",
"wname":"",
"color":"",
"description":"",
"promotion":"",
"skuId":"",
"secKill":"",
"directShow":"",
"showMartPrice":"",
"canFreeRead":"",
"size":""
  }],
"resultCode":""
  }
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareSkuSearchListGetRequest request=new WareSkuSearchListGetRequest();
request.setSkuId( 123 );
request.setClient( "jingdong" );
WareSkuSearchListGetResponse response=client.execute(request);

6. 获取商品详情列表
接口名称

jingdong.ware.product.detail.search.list.get

API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
skuId  Number  967403  商品编号 
isLoadWareScore  Boolean  true  是否加载商品积分,true加载,false不加载 
client  String  apple 

客户端类型

(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad)

非移动应用调取默认设置为m 

返回结果

名称 类型 示例值 描述
productDetailList  ProductDetailList 

ProductDetailList属性

名称 类型 是否必须 示例值 描述
resultCode  Number 
接口返回信息码 
productInfo  ProductInfo 
商品详情对象
imagePaths  ImagePath[] 
图片路径信息对象

ProductInfo属性

名称 类型 是否必须 示例值 描述
imgUrlN5  String 
N5图片路径 
secKill  Boolean 
是否秒杀 
wname  String 
商品名称 
adword  String 
广告词 
marketPrice  Number 
市场价 
averageScore  Number 
评价评分 
promotion  Boolean 
是否促销 
jdPrice  Number 
京东价 
good  String 
好评度
canConsultFlag  Boolean 
是否可以咨询标志,true:是,false:否
size  String 
尺寸 
isbook  Boolean 
是否为图书 
totalCount  Number 
总数量 
color  String 
颜色 
description  String 
描述 
directShow  Boolean 
是否直接展示  true:是,false:否
canFreeRead  Boolean 
是否免费阅读  true:是,false:否
showMartPrice  Boolean 
是否展示市场价  true:是,false:否
skuId  Number 
商品编号 
imgUrlN1  String 
N1图片路径 
imgurl  String 
商品大图片地址

ImagePath属性

名称 类型 是否必须 示例值 描述
newpath  String 
小图片地址
bigpath  String 
大图片地址
skuId  Number 
商品编号 

返回示例

JSON数据格式

{
  "jingdong_ware_product_detail_search_list_get_responce":{
  "productDetailList":{
  "resultCode":"",
"productInfo":{
  "imgUrlN5":"",
"wname":"",
"adword":"",
"marketPrice":"",
"averageScore":"",
"promotion":"",
"jdPrice":"",
"good":"",
"canConsultFlag":"",
"size":"",
"isbook":"",
"color":"",
"totalCount":"",
"description":"",
"skuId":"",
"secKill":"",
"directShow":"",
"showMartPrice":"",
"canFreeRead":"",
"imgUrlN1":"",
"imgurl":""
  },
"imagePaths":[{
  "skuId":"",
"newpath":"",
"bigpath":""
  }]
  }
  }
  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareProductDetailSearchListGetRequest request=new WareProductDetailSearchListGetRequest();
request.setSkuId( 123 );
request.setIsLoadWareScore( true );
request.setClient( "jingdong" );
WareProductDetailSearchListGetResponce responce=client.execute(request);

7.获取商品基本信息
接口名称

jingdong.ware.baseproduct.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
ids  Number[]  500200  skuId
(每次调用支持50个sku的查询)
base  String[]  brandName  需要查询的字段,与返回值ProductBase中的字段对应 

返回结果

名称 类型 示例值 描述
product_base  ProductBase[] 
sku基本信息 

ProductBase属性

名称 类型 是否必须 示例值 描述
sku_id  Number  500200  skus编码 
name  String  雅诗兰黛紧致眼霜  sku名称 
image_path  String  http://img13.360buyimg.com/n1/3013/3c478d95-bfae-4776-b962-f866033580b0.jpg  sku主图地址 
state  Number  0、下柜,1、上柜,2、可上柜(基本信息完备,采销没有正式上柜),10、POPSKU删除  上下柜状态 
is_delete  Number  0无效,1有效  是否有效 
brand_name  String  雅诗兰黛  品牌名称 
value_weight  String  单位:千克  高精度重量,double类型 
length  Number  单位:毫米  长 
width  Number  单位:毫米  宽 
height  Number  单位:毫米  高 
value_pay_first  Number  0否,1是  是否在线支付商品 
weight  Number  单位:千克,因JOS平台对double类型的处理上是给默认值,所以每次请求其他参数时(如name),也会返回weight:0。不是接口原因,请忽略此状况  重量 
cid2  Number  商品的第二分类(3级) 
product_area  String  北京  商品产地 
sale_date  Date  如果当前商品状态是上柜,saleDate为上柜日期;反之为下柜日期  上下柜日期 
wserve  String  无、无质保、1年质保、3年质保  质保 
allnum  Number  0、未设置标签,1、新品,2、热卖  图片标签 默认0 没有标签 
brand_id  Number  11516  新品牌id 
color  String  灰色  颜色 
color_sequence  Number  颜色顺序 
size  String  175/96A/M  尺码 
size_sequence  Number  尺码顺序 
ebrand  String  21hz  品牌英文名称 
cbrand  String  21赫兹  品牌中文名称 
model  String  12支装  型号 
category  String  652;654;833  分类信息,格式为:一级分类;二级分类;三级分类 

返回示例

JSON数据格式

{
  "jingdong_ware_baseproduct_get_response":{
  "product_base":[{
  "size_sequence":"0",
"model":"12支装",
"weight":"单位:千克,
因JOS平台对double类型的处理上是给默认值,所以每次请求其他参数时(如name),也会返回weight:0。不是接口原因,请忽略此状况",
"wserve":"无、无质保、1年质保、3年质保",
"color_sequence":"0",
"state":"0、下柜,1、上柜,2、可上柜(基本信息完备,采销没有正式上柜),10、POPSKU删除",
"is_delete":"0无效,1有效",
"brand_name":"雅诗兰黛",
"value_weight":"单位:千克",
"allnum":"0、未设置标签,1、新品,2、热卖",
"height":"单位:毫米",
"name":"雅诗兰黛紧致眼霜",
"length":"单位:毫米",
"sku_id":"500200",
"sale_date":"如果当前商品状态是上柜,saleDate为上柜日期;反之为下柜日期",
"value_pay_first":"0否,1是",
"cbrand":"21赫兹",
"width":"单位:毫米",
"brand_id":"11516",
"cid2":"0",
"ebrand":"21hz",
"size":"175/96A/M",
"category":"652;654;833",
"color":"灰色",
"product_area":"北京",
"image_path":"http://img13.360buyimg.com/n1/3013/3c478d95-bfae-4776-b962-f866033580b0.jpg",
  }]
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareBaseproductGetRequest request=new WareBaseproductGetRequest();
request.setIds( "123,234,345" );
request.setBase( "jingdong,yanfa,pop" );
WareBaseproductGetResponse response=client.execute(request);

8.获取商品分类信息

接口名称

jingdong.ware.productsort.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
product_sort_ids  Number[]  652,833  可批量查询分类ID,中间用逗号分隔 

返回结果

名称 类型 示例值 描述
product_sorts  ProductSort[]  652  分类信息详情 

ProductSort属性

名称 类型 是否必须 示例值 描述
product_sort_id  Number  652  分类ID 
father_id  Number  父类ID 
name  String  大家电  分类名称 
is_delete  Number  1是0否  是否有效 
grade  Number  0:一级,1:二级,2:三级  分类级别 
conte  String  1是0否  是否上柜 
sort  Number  排序,内部ERP使用,对外无实际用途 
is_fit_service  Number  1是0否  是否提供安装服务 

返回示例

JSON数据格式

{
  "jingdong_ware_productsort_get_response":{
  "product_sorts":[{
  "is_fit_service":"1是0否",
"sort":"0",
"conte":"1是0否",
"product_sort_id":"652",
"name":"大家电",
"father_id":"0",
"grade":"0:一级,1:二级,2:三级",
"is_delete":"1是0否"
  }]
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareProductsortGetRequest request=new WareProductsortGetRequest();
request.setProductSortIds( "123,234,345" );
WareProductsortGetResponse response=client.execute(request);

9.获取商品大字段信息

接口名称

jingdong.ware.productbigfield.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
sku_id  String  500200  skuId 
field  String[]  wareQD  传入要查询的字段,如:wareQD(包装清单)、propCode(规格参数)、wdis(商品介绍)、shouhou(售后)。可单独查询一个字段,也可查询多个,查多个时用逗号分隔。如:prop_code,wdis 

返回结果

名称 类型 示例值 描述
shou_hou  String 
售后 
wdis  String 
商品介绍 
prop_code  String 
规格参数 
ware_qd  String 
包装清单 

返回示例

JSON数据格式

{
  "jingdong_ware_productbigfield_get_response":{
  "prop_code":"",
"wdis":"",
"ware_qd":"",
"shou_hou":""
  }

  }


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareProductbigfieldGetRequest request=new WareProductbigfieldGetRequest();
request.setSkuId( "jingdong" );
request.setField( "jingdong,yanfa,pop" );
WareProductbigfieldGetResponse response=client.execute(request);

10.获取图书大字段信息

接口名称

jingdong.ware.bookbigfield.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
sku_id  Number[] 
skuid 

返回结果

名称 类型 示例值 描述
BookBigFieldEntity  BookBigFieldEntity[] 
返回图书大字段信息集合 

BookBigFieldEntity属性

名称 类型 是否必须 示例值 描述
sku_id  Number 
Sku编码 
first_class_id  Number 
一级分类 
book_big_field_info  BookBigFieldInfo 
图书大字段信息字段 

bookVideoBigFieldInfo属性

名称 类型 是否必须 示例值 描述
comments  String 
媒体评论 
image  String 
精彩文摘与插图(插图) 
content_desc  String 
内容摘要(内容简介) 
relatedProducts  String 
产品描述(相关商品) 
editer_desc  String 
编辑推荐 
catalogue  String 
目录 
book_abstract  String 
精彩摘要(精彩书摘) 
authorDesc  String 
作者简介 
introduction  String 
前言(前言/序言) 

返回示例

JSON数据格式

{
  "jingdong_ware_bookbigfield_get_response":{
  "BookBigFieldEntity":[{
  "book_big_field_info":{
  "book_abstract":"",
"relatedProducts":"",
"catalogue":"",
"authorDesc":"",
"content_desc":"",
"image":"",
"editer_desc":"",
"introduction":"",
"comments":""
  },
"first_class_id":"",
"sku_id":""
  }]
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareBookbigfieldGetRequest request=new WareBookbigfieldGetRequest();
request.setSkuId( "123,234,345" );
WareBookbigfieldGetResponse response=client.execute(request)

11.获取商品图片信息(多图)

接口名称

jingdong.ware.productimage.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
sku_id  Number[]  sku_id 

返回结果

名称 类型 示例值 描述
image_path_list  ImagePath[] 
图片信息 

imagePathList属性

名称 类型 是否必须 示例值 描述
sku_id  Number 
Sku编码 
image_list  Image[] 
图片信息 

imageList属性

名称 类型 是否必须 示例值 描述
id  Number 
Id编码 
sku_id  Number 
Sku编码 
path  String 
图片绝对路径 
yn  Number 
1 有效、0无效 
is_primary  Number 
1 主图 0辅图 
orderSort  Number 
排序 
position  Number 
备用字段,尚未启用 
type  Number 
1 长图 0 普通主图 

返回示例

JSON数据格式

{
  "jingdong_ware_productimage_get_response":{
  "image_path_list":[{
  "image_list":[{
  "position":"",
"id":"",
"orderSort":"",
"path":"",
"yn":"",
"is_primary":"",
"sku_id":"",
"type":""
  }],
"sku_id":""
  }]
  }

  }


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareProductimageGetRequest request=new WareProductimageGetRequest();
request.setSkuId( "123,234,345" );
WareProductimageGetResponse response=client.execute(request);

12.获取音像大字段信息

接口名称

jingdong.ware.videobigfield.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
skuId  Number[] 
skuId 

返回结果

名称 类型 示例值 描述
VideoBigFieldEntity  VideoBigFieldEntity[] 
音像大字段信息集合 

VideoBigFieldEntity属性

名称 类型 是否必须 示例值 描述
skuId  Number 
Sku编码 
firstClassId  Number 
一级分类 
videoBigFieldInfo  VideoBigFieldInfo 
音像大字段信息 

bookVideoBigFieldInfo属性

名称 类型 是否必须 示例值 描述
comments  String 
评论 
image  String 
商品描述 
contentDesc  String 
内容简介 
editerDesc  String 
编辑推荐 
catalogue  String 
目录 
box_Contents  String 
包装清单 
material_Description  String 
特殊说明 
manual  String 
说明书 

返回示例

JSON数据格式

{
  "jingdong_ware_videobigfield_get_response":{
  "VideoBigFieldEntity":[{
  "videoBigFieldInfo":{
  "manual":"",
"catalogue":"",
"image":"",
"editerDesc":"",
"material_Description":"",
"box_Contents":"",
"contentDesc":"",
"comments":""
  },
"firstClassId":"",
"skuId":""
  }]
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareVideobigfieldGetRequest request=new WareVideobigfieldGetRequest();
request.setSkuId( "123,234,345" );
WareVideobigfieldGetResponse response=client.execute(request);

13.获取音像基本信息

接口名称

jingdong.ware.basevideo.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
skuId  Number[] 
skuId 

返回结果

名称 类型 示例值 描述
videoEntitys  VideoEntity[] 
返回音像基本信息集合 

VideoEntity属性

名称 类型 是否必须 示例值 描述
skuId  Number 
Sku编码 
videoInfo  VideoInfo 
音像详细字段 

点击查看  VideoInfo属性

返回示例

JSON数据格式

{
  "jingdong_ware_basevideo_get_response":{
  "videoEntitys":[{
  "skuId":"",
"videoInfo":{
  "type_keywords":"",
"mvd_gqyz":"",
"language_pronunciation":"",
"aka":"",
"isrc":"",
"voiceover":"",
"actor":"",
"finishing":"",
"type":"",
"audio_encoding_chinese":"",
"authors":"",
"mfg_minimum":"",
"compose":"",
"screenwriter":"",
"quality_description":"",
"record_number":"",
"platform":"",
"screen_ratio":"",
"keywords":"",
"foreignname":"",
"barcode":"",
"copyright":"",
"format":"",
"director":"",
"soundtrack":"",
"menu_language":"",
"awards":"",
"number_of_discs":"",
"included_additional_item":"",
"recommended_system_description":"",
"performer":"",
"mfg_maximum":"",
"language":"",
"dub":"",
"media":"",
"region":"",
"press":"",
"episode":"",
"singer":"",
"orchestra":"",
"photography":"",
"version":"",
"mvd_wxjz":"",
"set_the_number_of":"",
"compile":"",
"isbn":"",
"write":"",
"command":"",
"length":"",
"read":"",
"production_company":"",
"dictation":"",
"mvd_wyjz":"",
"dregion":"",
"language_dubbed":"",
"sid":"",
"publishing_company":"",
"mvd_xcyg":"",
"online_play_description":"",
"minimum_system_requirement_description":"",
"readers":"",
"language_subtitled":"",
"first_category":"1713为图书、4051、4052、4053是音像",
"number_of_players":"",
"accessories":"",
"color":"",
"version_language":"",
"producer":"",
"release_date":"",
"brand":"",
"mvd_dcz":"",
"publication_date":""
  }
  }]
  }

  }

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareBasevideoGetRequest request=new WareBasevideoGetRequest();
request.setSkuId( "123,234,345" );
WareBasevideoGetResponse response=client.execute(request);

14.获取图书基本信息

接口名称

jingdong.ware.basebook.get


API用户授权类型

不需要

系统级别输入参数

名称 类型 是否必须 描述
method String API接口名称
access_token String 采用OAuth授权方式为必填参数
app_key String 应用的app_key
sign String 签名
timestamp String 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format String 暂时只支持json
v String API协议版本,可选值:2.0

应用级输入参数

名称 类型 是否必须 示例值 描述
sku_id  Number[] 
skuid 

返回结果

名称 类型 示例值 描述
BookEntity  BookEntity[] 
返回图书基本信息集合 

BookEntity属性

名称 类型 是否必须 示例值 描述
sku_id  Number 
Sku编码 
book_info  BookInfo 
图书详细字段 

bookVideoInfo属性

名称 类型 是否必须 示例值 描述
id  String 
图书编号 
first_category  Number  1713为图书、4051、4052、4053是音像  一级分类 
isbn  String 
isbn 
issn  String 
issn 
book_name  String 
营销书名 
foreign_book_name  String 
外文书名 
language  String 
图书语言 
author  String 
作者 
editer  String 
编者 
proofreader  String 
校对 
remarker  String 
注释 
transfer  String 
译者 
drawer  String 
绘者 
publishers  String 
出版社 
publish_no  String 
出版社号 
series  String 
丛书名 
brand  String 
品牌 
format  String 
格式 
packages  String 
包装 
pages  String 
页数 
batch_no  String 
版次 
publish_time  String 
出版时间 
print_no  Number 
印次 
print_time  String 
印刷时间 
size_and_height  String 
尺寸及重量 
china_catalog  String 
中国法分类号 
sheet  String 
印张 
papers  String 
用纸 
attachment  String 
附件 
attachment_num  Number 
附件数量 
pack_num  Number 
套装数量 
letters  Number 
字数 
bar_code  String 
条形码 
keywords  String 
主题词 
pick_state  String 
捡货标记 
compile  String 
编纂 
photography  String 
摄影 
dictation  String 
口述 
read  String 
朗读 
finishing  String 
整理 
write  String 
书写 

返回示例

JSON数据格式 

{
  "jingdong_ware_basebook_get_response":{
  "BookEntity":[{
  "sku_id":"",
"book_info":{
  "series":"",
"publish_no":"",
"pack_num":"",
"publishers":"",
"issn":"",
"finishing":"",
"drawer":"",
"photography":"",
"china_catalog":"",
"id":"",
"author":"",
"size_and_height":"",
"book_name":"",
"compile":"",
"proofreader":"",
"isbn":"",
"write":"",
"print_time":"",
"read":"",
"dictation":"",
"batch_no":"",
"sheet":"",
"print_no":"",
"transfer":"",
"keywords":"",
"packages":"",
"bar_code":"",
"pages":"",
"foreign_book_name":"",
"papers":"",
"attachment":"",
"first_category":"1713为图书、4051、4052、4053是音像",
"format":"",
"publish_time":"",
"remarker":"",
"pick_state":"",
"brand":"",
"attachment_num":"",
"language":"",
"letters":"",
"editer":""
  }
  }]
  }

  }


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WareBasebookGetRequest request=new WareBasebookGetRequest();
request.setSkuId( "123,234,345" );
WareBasebookGetResponse response=client.execute(request);