服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【商品服务】接口导航


1. 添加商品 2. 修改商品
3. 商品上架 4. 商品下架
5. 删除商品信息 6. 根据商品ID查询单个商品的详细信息
7. 批量获取商品信息      8. 检索商品信息
9. 获取商品上架的商品信息  10. 获取商品下架的商品信息

 

11. 根据商品Id，销售属性值Id查询图片 12. 根据商品Id，销售属性值Id增加图片
13. 根据商品Id，销售属性值Id删除图片 14. 根据商品Id，销售属性值Id设置图片
15. 根据商品Id，检索商品主图  

 

16. 设置商品限购区域  17. 查询商品限购区域

 

18.添加关联版式 19. 修改关联版式
20. 删除关联版式 21. 查询关联版式id以及名称
22. 查询关联版式详情 23. 设置关联版式到商品

1. 添加商品
  

l  接口名称


     360buy.ware.add

 

l  功能说明


     新增一个商品

 

l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

cid

String

是

1354

类目id

shop_category

String

否

206-208;207-208

206(一级)-208(二级);207(一级)-

207(一级)


商品所属的自定义店内分类列表。按分号分隔。

结构："cid1-cid11;cid2-cid22;..."

如果自定义店内分类存在叶子类目，格式是cid1-cid11

如果自定义店内分类不存在叶子类目，格式是cid1-cid1

title

String

是

 

标题（字数限制：45）

upc_code

String

否

 

upc编码

option_type

String

否

 如下架传入：offsale

操作类型，现只支持：offsale 或onsale

下架类型请传入：offsale

上架类型请传入：onsale

如果不传默认为下架状态

item_num

String

否

 

外部商品编号，对应商家后台“货号”

ware_locationstring否北京产地

producter

String

否

 

生产厂商

wrap

String

否

 

包装规格

length

String

是

 

长(单位:mm)

如不确定，默认为0。

wide

String

是

 

宽(单位:mm)

如不确定，默认为0。

high

String

是

 

高(单位:mm)

如不确定，默认为0。

weight

String

是

 

重量(单位:kg)

如不确定，默认为0。

cost_price

String

否

 

进货价

market_price

String

是

 

市场价

（支持小数点格式的商品类目：图书、音乐、影视、教育音像、个护化妆）

jd_price

String

是

 

京东价

（支持小数点格式的商品类目：图书、音乐、影视、教育音像、个护化妆）

notes

String

是

 

描述（最多支持3万个英文字符）

ware_image

byte[]

是

 

图片信息，通过程序对图片进行Byte[] 格式的处理后，生成参数信息（第一 读取图片；第二 将图片通过base64转化成字符串，然后赋值给ware_image属性）图片类型只支持：png和jpg的，图片须800x800的  图片不能大于1M


根据URL换码协议，会将POST发送的数据里面是"+"全部被替换成空格，所以ware_image参数经过MD5加密完毕后，需要将ware_image对应的值中的"+"转换成%2B（如果php.ini配置自动转义，则不需要转码）


pack_listing

String

否

 

包装清单

service

String

否

 

售后服务

stock_num

String

是

 

库存数

property_alias

String

否

 1000000041:1500368001:淡蓝色

自定义属性值别名： 属性ID:属性值ID:别名 ，多组之间用^分开，如aid:vid:别名^aid1:vid1:别名1

attributes

String

是

3205:22101|3205:22102

商品属性列表,多组之间用"|"分隔，格式:aid:vid  或 aid:vid|aid1:vid1 或 aid1:vid1（需要从类目服务接口获取）

如输入类型input_type为1或2，则attributes为必填属性；如输入类型input_type为3，则用字段input_str填入属性的值

sku_prices

String

否

12|13

sku 价格,多组之间用"|"分隔，格式:p1|p2

sku_properties

String

否

100041:150041^1000046:15844|1001:

1501^10006:1504

sku 属性,一组sku 属性之间用"^"分隔，多组用"|"分隔格式:aid:vid^aid1:vid2|aid3:vid3^aid4:vid4

（需要从类目服务接口获取）

sku_stocks

String

否

 

sku 库存,多组之间用"|"分隔， 格式:s1|s2

outer_id

String

否

 

SKU外部ID，对个之间用"|"分隔格，比如：sdf|sds（支持没有sku的情况下，可以输入外部id，并将外部id绑定在默认生成的sku上），对应商家后台“商家skuid”

trade_no

String

否

 

流水号

is_pay_first

String

否

"true"

是否先款后货 , false为否，true为是

is_can_vat

String

否

"true"

发票限制：非必须输入，true为限制，false为不限制开增值税发票，FBP、LBP、SOPL、SOP类型商品均可输入；

is_imported

String

否

"true"

是否进口商品：非必须输入，false为否，true为是，FBP类型商品可输入；

is_health_product

String

否

"false"

是否保健品：非必须输入，false为否，true为是，FBP类型商品可输入；

is_shelf_life

String

否

false

是否保质期管理商品, false为否，true为是

shelf_life_days

String

否

"999"

保质期：非必须输入，0-99999范围区间，FBP类型商品可输入；

is_serial_no

String

否

"true"

是否序列号管理：非必须输入，false为否，true为是，FBP类型商品可输入；

is_appliances_card

String

否

"true"

大家电购物卡：非必须输入，false为否，true为是，FBP类型商品可输入；

is_special_wet

String

否

"false"

是否特殊液体：非必须输入，false为否，true为是，FBP、LBP、SOPL类型商品可输入；

ware_big_small_model

String

是（FBP必须输入）

"2"

商品件型：必须输入，0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件，FBP类型商品必须输入；

ware_pack_type

String

是（FBP必须输入）

"2"

商品包装：必须输入，1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库，FBP类型商品必须输入；

input_pidsString所选pid输入类型等于3，pid是必须输入1132632|12142|876231用户自行输入的类目属性ID串结构："pid1|pid2|pid3",
属性的pid调用360buy.ware.get.attribute取得, 输入类型input_type=3即输入
input_strsString 内容1|内容2|内容3

用户自行输入的属性值,结构:"输入值|输入值2|输入值3"


图书品类输入值规则：

ISBN：数字、字母格式
出版时间：日期格式“yyyy-mm-dd”
版次：数字格式
印刷时间：日期格式“yyyy-mm-dd”
印次：数字格式
页数：数字格式
字数：数字格式
套装数量：数字格式
附件数量：数字格式

has_check_code

string

否"true"

是否输入验证码 true:是;false:否

ad_content

string

否

"广告词内容"

广告词内容最大支持45个字符

list_time

string

否

"2013-08-19 15:24:43"

定时上架时间  时间格式：yyyy-MM-dd HH:mm:ss ;规则是大于当前时间，10天内。

*注意：sku_prices、sku_properties、sku_stocks和outer_id四个参数的sku组数必须保持一致(如果当前录入的商品有sku,则必须录入，否则以上四个属性均不需要录入)

l  返回结果

 

名称

类型

是否必须

示例值

描述

created

String

 

 

更改时间

ware_id

long

 

 

商品的id

skusList< SkuInfo >  SKU集合

code

String

 

 

0为正常，其它值参见错误代码一览表

SkuInfo结构


名称

类型

是否必须

示例值

描述

sku_id

String

 

 

skuid

attribute

String

 

 

Sku的属性


l  返回示例

    JSON数据格式

{

    "ware_add_response": {

        "code": "0",

        "ware_id": 1100000015,

        "created": "2012-01-06 11:13:19",

      "skus":[

              {

         "sku_id":"1200000011",

        "attribute":"100041:150041^1000046:15844"

         },

       {

         "sku_id":"1200000085",

        "attribute":"100041:150041^1000047:15849"

         }

]

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareAddRequest wareAddRequest= new WareAddRequest();

wareAddRequest.setCid("1354"); //类目  服饰鞋帽 > 女装 > 衬衫 (1354)   药品 > 感冒用药 > 风寒风热(6359)

wareAddRequest.setWareImage(imageFactory());  //主图

wareAddRequest.setTitle("API商品测试-商品名称1111");

wareAddRequest.setLength("1");

wareAddRequest.setWide("2");

wareAddRequest.setHigh("3");

wareAddRequest.setWeight("11");

wareAddRequest.setMarketPrice("500"); //市场价

wareAddRequest.setJdPrice("444");     //京东价

wareAddRequest.setNotes("描述123123
");//描述

wareAddRequest.setPackListing("包装清单"); //包装清单

wareAddRequest.setService("售后服务");     //售后服务

wareAddRequest.setStockNum("100");

wareAddRequest.setAttributes("3205:64734|3206:22107");

       wareAddRequest.setSkuProperties("1000000041:150029941^1000000046:150029944|1000000041:150029941^1000000046:150029943");

wareAddRequest.setSkuPrices("300|500");

wareAddRequest.setSkuStocks("10|90");

WareAddResponse wareAddResponse= client.execute(wareAddRequest);

  
2. 修改商品
  

l  接口名称

    

360buy.ware.update

 

l  功能说明 

            

通过api 根据ware_id 商品编号 修改商品信息


l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

ware_id

String

是

1354

商品id

shop_category

String

否

 

自定义店内分类  (保留字段)

title

String

否

 

标题

upc_code

String

否

 

upc编码

option_type

String

否

 

操作类型，现只支持：offsale 或onsale

下架类型请传入：offsale

上架类型请传入：onsale

如果不传操作类型，商品保持原状态


item_num

String

否

 

外部商品编号，对应商家后台“货号”

outer_id

String

否

 

SKU外部ID，对应商家后台“商家skuid”多组之间用"|"分隔，格式:sku1|sku2

ware_locationString否北京产地

producter

String

否

 

生产厂商

wrap

String

否

 

包装规格

length

String

否

 

长(单位:mm)

如不确定，默认为0。

wide

String

否

 

宽(单位:mm)

如不确定，默认为0。

high

String

否

 

高(单位:mm)

如不确定，默认为0。

weight

String

否

 

重量(单位:kg)

如不确定，默认为0。

cost_price

String

否

 

进货价

market_price

String

否

 

市场价

（支持小数点格式的商品类目：图书、音乐、影视、教育音像、个护化妆）

jd_price

String

否

 

京东价

（支持小数点格式的商品类目：图书、音乐、影视、教育音像、个护化妆）

notes

String

否

 

描述

pack_listing

String

否

 

包装清单

service

String

否

 

售后服务

property_alias

String

否

 1000000041:1500368001:淡蓝色

自定义属性别名： 属性ID:属性值ID:别名 ，多组之间用^分开，如aid:vid:别名^aid1:vid1:别名1

attributes

String

否（如该商品有必填属性则为必填）

3205:22101|3205:22102

商品属性列表,多组之间用"|"分隔，格式:aid:vid  或 aid:vid|aid1:vid1 或 aid1:vid1 （需要从类目服务接口获取）,如果有属性是可输入的话，则用字段input_str填入属性的值

sku_prices

String

否

12|13

sku 价格,多组之间用"|"分隔，格式:sku1|sku2

sku_properties

String

否

100041:150041^1000046:

15844|1001:1501^10006:1504

sku 属性,一组sku 属性之间用"^"分隔，多组用"|"分隔格式:aid:vid^aid1:vid2|aid3:vid3^aid4:vid4

（需要从类目服务接口获取）

sku_stocks

String

否

 

sku 库存,多组之间用"|"分隔， 格式:sku1|sku2

trade_no

String

否

 

流水号

is_pay_first

String

否

"true"

是否先款后货 , false为否，true为是

is_can_vat

String

否

"true"

发票限制：非必须输入，true为限制，false为不限制开增值税发票，FBP、LBP、SOPL、SOP类型商品均可输入；

is_imported

String

否

"true"

是否进口商品：非必须输入，false为否，true为是，FBP类型商品可输入；

is_health_product

String

否

"false"

是否保健品：非必须输入，false为否，true为是，FBP类型商品可输入；

is_shelf_life

String

否

false

是否保质期管理商品, false为否，true为是

shelf_life_days

String

否

"999"

保质期：非必须输入，0-99999范围区间，FBP类型商品可输入；

is_serial_no

String

否

"true"

是否序列号管理：非必须输入，false为否，true为是，FBP类型商品可输入；

is_appliances_card

String

否

"true"

大家电购物卡：非必须输入，false为否，true为是，FBP类型商品可输入；

is_special_wet

String

否

"false"

是否特殊液体：非必须输入，false为否，true为是，FBP、LBP、SOPL类型商品可输入；

ware_big_small_model

String

否（FBP类型商家适用，如不修改，可以不传）

"2"

商品件型：必须输入，0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件，FBP类型商家适用；

ware_pack_type

String

否（FBP类型商家适用，如不修改，可以不传）

"2"

商品包装：必须输入，1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库，FBP类型商家适用；

input_pidsString所选pid输入类型等于3，pid是必须输入1132632|12142|876231用户自行输入的类目属性ID串结构："pid1|pid2|pid3",
属性的pid调用360buy.ware.get.attribute取得, 输入类型input_type=3即输入
input_strsString 内容1|内容2|内容3

用户自行输入的属性值,结构:"输入值|输入值2|输入值3


图书品类输入值规则：
ISBN：数字、字母格式
出版时间：日期格式“yyyy-mm-dd”
版次：数字格式
印刷时间：日期格式“yyyy-mm-dd”
印次：数字格式
页数：数字格式
字数：数字格式
套装数量：数字格式
附件数量：数字格式

stock_numString否 库存数(针对FBP输入无效)

has_check_code

string

否"true"

是否输入验证码 true:是;false:否

ad_content

string

否

"广告词内容"

广告词内容最大支持45个字符

list_time

string

否

"2013-08-19 15:24:43"

定时上架时间  时间格式：yyyy-MM-dd HH:mm:ss；规则是大于当前时间，10天内。


*注意：sku_prices、sku_properties、sku_stocks和outer_id 四个参数的sku组数必须保持一致。

（如果当前录入的商品有sku,则必须录入，否则以上四个属性均不需要录入）

l  返回结果


名称

类型

是否必须

示例值

描述

modified

String

 

 

更改时间

ware_id

long

 

 

商品的id

skusList< SkuInfo >  SKU集合

code

String

 

 

0为正常，其它值参见错误代码一览表

SkuInfo结构


名称

类型

是否必须

示例值

描述

sku_id

String

 

 

skuid

attribute

String

 

 

Sku的属性

 

l  返回示例


JSON数据格式

{

    "ware_update_response": {

       "code": "0",

        "modified": "2012-01-06 11:13:19",

        "ware_id": 1100000015,

     "skus": [
            {
                "sku_id": "1200000011",
                "attribute": "100041:150041^1000046:15844"
            },
            {
                "sku_id": "1200000085",
                "attribute": "100041:150041^1000047:15849"
            }
        ]

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareUpdateRequest wareUpdateRequest = new WareUpdateRequest();

wareUpdateRequest.setWareId("1100028130");

wareUpdateRequest.setTitle("API商品测试-商品名称--修改商品");

wareUpdateRequest.setLength("11");

wareUpdateRequest.setWide("21");

wareUpdateRequest.setHigh("31");

wareUpdateRequest.setWeight("111");

wareUpdateRequest.setMarketPrice("799");

wareUpdateRequest.setJdPrice("680"); 

wareUpdateRequest.setNotes("描述1修改商品23123
");

wareUpdateRequest.setRate("331");

wareUpdateRequest.setPackListing("包装清单--修改商品"); 

wareUpdateRequest.setService("售后服务--修改商品");    wareUpdateRequest.setAttributes("3205:64734|3206:22107");

wareUpdateRequest.setSkuProperties("1000000041:150029941^1000000046:150029944|1000000041:150029941^1000000046:150029943");

wareUpdateRequest.setSkuPrices("600|700");

wareUpdateRequest.setSkuStocks("100|900");

WareUpdateResponse wareUpdateResponse= client.execute(wareUpdateRequest);

  
3.商品上架
   

l  接口名称 

    

360buy.ware.update.listing


l  功能说明 


         通过api 根据ware_id 商品编号 操作商品上架

 


l  系统级别输入参数 


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

trade_no

String

 

 

流水号


l  返回结果 


名称

类型

是否必须

示例值

描述

modified

String

 

 

更改时间

ware_id

long

 

 

商品的id

code

String

 

 

0为正常，其它值参见错误代码一览表


l  返回示例 


JSON数据格式

{

    "ware_update_listing_response": {

        "code": "0"

        "ware_id": 1100000015,

        "modified": "2012-01-06 11:13:19",

    }

}


l  SDK调用示例（java） 


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareUpdateListingRequest  wareUpdateListingRequest=new WareUpdateListingRequest();

wareUpdateListingRequest.setWareId("1100027676");

WareUpdateListingResponse res = client.execute(wareUpdateListingRequest);

  
4. 商品下架
  

l  接口名称 


360buy.ware.update.delisting

 

l  功能说明


          通过api 根据ware_id 商品编号 操作商品下架

 

l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

trade_no

String

 

 

流水号


l  返回结果


名称

类型

是否必须

示例值

描述

modified

String

 

 

更改时间

ware_id

long

 

 

商品的id

code

String

 

 

0为正常，其它值参见错误代码一览表


l  返回示例

JSON数据格式

{

    "ware_update_delisting_response": {

        "code": "0"

        "ware_id": 1100000015,

        "modified": "2012-01-06 11:13:19",

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareUpdateDelistingRequest  wareUpdateDelistingRequest=new WareUpdateDelistingRequest();

wareUpdateDelistingRequest.setWareId("1100000022");

WareUpdateDelistingResponse res = client.execute(wareUpdateDelistingRequest);

  
5. 删除商品信息
  

l  接口名称 

   

360buy.ware.delete

 

l  功能说明


            通过api 根据ware_id 商品编号 删除商品


l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

trade_no

long

 

 

流水号


l  返回结果


名称

类型

是否必须

示例值

描述

created

String

 

 

创建时间

ware_id

long

 

 

商品的id

code

String

 

 

0为正常，其它值参见错误代码一览表


l  返回示例 

JSON数据格式

{

    "ware_delete_response": {

        "code": "0"

        "ware_id": 1100000015,

        "created": "2012-01-06 11:22:15",

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareDeleteRequest  wareDeleteRequest= new WareDeleteRequest();

wareDeleteRequest.setWareId("1100000022");

WareDeleteResponse res = client.execute(wareDeleteRequest);

  
6. 根据商品ID查询单个商品的详细信息
  

l  接口名称 

     

360buy.ware.get

 

l  功能说明


           通过api接口，输入单个商品id，得到所有相关商品的全部信息



l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

fields

String

否

ware_id,spu_id

cid,

created

需返回的字段列表。可选值：ware结构体中的所有字段；字段之间用","分隔

ware_id

String

是

1100000015

商品的id


l  返回结果


名称

类型

示例值

描述

ware

Ware

 

商品信息

code

string

 

0为正常，其它值参见错误代码一览表

Ware结构


名称

类型

示例值

描述

ware_id

number

1100000015

商品ID

skus

Sku

1100000015

Sku对象信息, Sku对象信息,参见获取sku信息中的sku对象

spu_id

String

275333

spu ID

cid

number

1589

分类ID 三级类目ID

vender_id

number

20032

商家ID

shop_id

number

12314

店铺ID

ware_status

String

NEVER_UP

商品状态:

NEVER_UP:从未上架,

CUSTORMER_DOWN:自主下架

SYSTEM_DOWN:系统下架

ON_SALE:在售

AUDIT_AWAIT: 待审核

AUDIT_FAIL: 审核不通过

title

String

京东sop衬衫1

商品标题

item_num

String

23424

外部商品编号，对应商家后台"货号"

upc_code

String

6948807910044

UPC编码

transport_id

number

333

运费模板

online_time

String

2011-12-26 16:09:29

最后上架时间

offline_time

String

2011-12-26 16:14:20

最后下架时间

attributes

String

1001:1501^1006:1504

商品属性列表

desc

string

商品

商品描述

producter

String

 

生产厂商

wrap

String

 

包装规格

cubage

string

11:21:31

长:宽:高

pack_listing

String

 

包装清单

service

String

 

售后服务

cost_price

String

123.13

进货价, 精确到2位小数，单位:元

market_price

String

123.13

市场价, 精确到2位小数，单位:元

jd_price

String

12.13

京东价,精确到2位小数，单位:元

stock_num

number

10

库存

logo

String

1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg

商品的主图

creator

String

路由器

录入人

status

number

Delete

状态：

Delete:删除

Invalid:无效

Valid :有效

weight

String

10

重量,单位:公斤

created

String

2011-11-04 15:24:43

WARE_WARE创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

String

2011-11-04 15:34:43

WARE_WARE修改时间

时间格式：yyyy-MM-ddHH:mm:ss

outer_id

String

Af1315

SKU外部ID，对应商家后台"商家skuid"(保留字段）

shop_categorys

String

206-208;207-207
206(一级)-208(二级);207(一级)-207(一级)

自定义店内分类

is_pay_first

Boolean

true

是否先款后货 支付方式 false：非  true：是

is_can_vat

Boolean

true

发票限制： true为限制，false为不限制开增值税发票

is_imported

Boolean

true

是否进口商品： false为否，true为是

is_health_product

Boolean

true

是否保健品： false为否，true为是

is_shelf_life

Boolean

true

是否保质期管理商品, false为否，true为是

shelf_life_days

Integer

999

保质期： 0-99999范围区间

is_serial_no

Boolean

true

是否序列号管理： false为否，true为是

is_appliances_card

Boolean

true

大家电购物卡： false为否，true为是

is_special_wet

Boolean

true

是否特殊液体： false为否，true为是

ware_big_small_model

Integer

2

商品件型： 0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件

ware_pack_type

Integer

2

商品包装： 1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库

ad_content

string

 广告语

l  返回示例

JSON数据格式

{

  "ware_get_response":{

    "code":"0"

    "ware ":{

           "attributes":"3767:25944^3768:25945^3769:25950",

              "status":" Delete",

              "transport_id":0,

              "vender_id":20032,

              "cid":1589,

              "ware_id":1100000015,

              "spu_id":0,

              "shop_id":16,

              "ware_status":"CUSTORMER_DOWN",

              "title":"333",

              "item_num":"null",

              "upc_code":"hahaa...",

              "online_time":"2011-12-26 16:09:29",

              "offline_time":"2011-12-26 16:14:20",

              "cost_price":"10.00",

              "market_price":"20.00",

              "jd_price":"20.00",

              "stock_num":0,

              "logo":"1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg",

              "creator":"null",

              "weight":"10.0",

              "created":"2010-07-22 12:01:43",

              "modified":"2011-12-30 16:35:43",

              "outer_id":"null","skus":""

               },

       }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareGetRequest  wareGetRequest= WareGetRequest();

wareGetRequest.setWareId("1100000015");

wareGetRequest.setFields("");

WareGetResponseres= client.execute(wareGetRequest);

 

  
7. 批量获取商品信息
  

l  接口名称 

     

360buy.wares.list.get


l  功能说明


                通过api接口，输入多个商品id（多个id用逗号分隔），批量得到所有相关商品的全部信息


l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

fields

String

  否

ware_id,spu_id,cid,

需返回的字段列表。可选值：ware结构体中的所有字段；字段之间用","分隔

ware_ids

String

 是

1100000015,1100000016

商品的id，用逗号分隔,最多不能超过10个


l  返回结果


名称

类型

示例值

描述

wares

List

 

商品信息

totalint 总记录数

code

string

 

0为正常，其它值参见错误代码一览表

 


Ware结构


名称

类型

示例值

描述

ware_id

number

1100000015

商品ID

skus

Sku

1100000015

Sku对象信息

spu_id

String

275333

spu ID

cid

number

1589

分类ID 三级类目ID

vender_id

number

20032

商家ID

shop_id

number

12314

店铺ID

ware_status

String

NEVER_UP

商品状态:

NEVER_UP:从未上架,

CUSTORMER_DOWN:自主下架

SYSTEM_DOWN:系统下架

ON_SALE:在售

AUDIT_AWAIT: 待审核

AUDIT_FAIL: 审核不通过

title

String

京东sop衬衫1

商品标题

item_num

String

23424

外部商品编号，对应商家后台"货号"

upc_code

String

6948807910044

UPC编码

transport_id

number

333

运费模板

online_time

String

2011-12-26 16:09:29

最后上架时间

offline_time

String

2011-12-26 16:14:20

最后下架时间

attributes

String

1001:1501^1006:1504

可选属性

desc

string

商品

商品描述

producter

String

 

生产厂商

wrap

String

 

包装规格

cubage

string

长:宽:高

11:21:31

pack_listing

String

 

包装清单

service

String

 

售后服务

cost_price

String

123.13

进货价, 精确到2位小数，单位:元

market_price

String

123.13

市场价, 精确到2位小数，单位:元

jd_price

String

12.13

京东价,精确到2位小数，单位:元

stock_num

number

10

库存

logo

String

9041-285d341422ca.jpg

商品的主图

creator

String

路由器

录入人

status

number

Delete

状态：

Invalid:无效

Valid :有效

weight

String

10

重量,单位:公斤

created

String

2011-11-04 15:24:43

WARE_WARE创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

String

2011-11-04 15:34:43

WARE_WARE修改时间

时间格式：yyyy-MM-ddHH:mm:ss

shop_categorys

String

206-208;207-207
206(一级)-208(二级);207(一级)-207(一级)

自定义店内分类

is_pay_first

Boolean

true

是否先款后货 支付方式 false：非  true：是

is_can_vat

Boolean

true

发票限制： true为限制，false为不限制开增值税发票

is_imported

Boolean

true

是否进口商品： false为否，true为是

is_health_product

Boolean

true

是否保健品： false为否，true为是

is_shelf_life

Boolean

true

是否保质期管理商品, false为否，true为是

shelf_life_days

Integer

999

保质期： 0-99999范围区间

is_serial_no

Boolean

true

是否序列号管理： false为否，true为是

is_appliances_card

Boolean

true

大家电购物卡： false为否，true为是

is_special_wet

Boolean

true

是否特殊液体： false为否，true为是

ware_big_small_model

Integer

2

商品件型： 0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件

ware_pack_type

Integer

2

商品包装： 1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库

SKU结构

名称

类型

示例值

描述

sku_id

number

2323

sku的id

shop_id

number

12314

店铺id

ware_id

number

123122

sku所属商品id

status

String

Valid

sku状态

有效：Valid

无效：Invalid

删除：Delete

attributes

string

1001:1501^1006:1504

sku的销售属性组合字符串（颜色，大小，等等，可通过类目API获取某类目下的销售属性）,格式是aid1:vid1;aid2:vid2

stock_num

number

10

库存

jd_price

string

12.13

京东价,精确到2位小数，单位元

cost_price

string

123.13

进货价, 精确到2位小数，单位元

market_price

string

123.13

市场价, 精确到2位小数，单位元

outer_id

string

Af1315

外部id,商家设置的外部id

created

string

2011-11-04 15:24:43

sku创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified  

string

2011-11-04 15:34:43

sku修改时间

时间格式：yyyy-MM-ddHH:mm:ss

color_value        

string


颜色对应的值

size_value       

string


尺码对应的值

 

l  返回示例

JSON数据格式

{
    "ware_list_response": {
        "code": "0",
        "total": 1,
        "wares": [
            {
                "skus": [
                    {
                        "status": "VALID",
                        "attributes": "1000012836:1503777990^1000012837:1503829446",
                        "created": "2014-02-25 15:40:58",
                        "modified": "2014-02-25 15:42:39",
                        "sku_id": 1000012,
                        "ware_id": 100001,
                        "shop_id": 1001,
                        "jd_price": "119.00",
                        "cost_price": "0.00",
                        "market_price": "232.00",
                        "stock_num": 1,
                        "outer_id": "",
                        "color_value": "深红色",
                        "size_value": "S"
                    },
                    {
                        "status": "VALID",
                        "attributes": "1000012836:1503777897^1000012837:1503829446",
                        "created": "2014-02-25 15:40:58",
                        "modified": "2014-02-25 15:42:39",
                        "sku_id": 100001,
                        "ware_id": 1000011,
                        "shop_id": 1001,
                        "jd_price": "119.00",
                        "cost_price": "0.00",
                        "market_price": "232.00",
                        "stock_num": 1,
                        "outer_id": "",
                        "color_value": "橙色",
                        "size_value": "S"
                    }
                ],
                "title":"京东测试商品数据"
                "attributes": "15276:232374^1000012836:1503777900,1503777897,1503777990,1503777936^1000012837:1503829446",
                "logo": "http://img10.360buyimg.com/n0/g15/M00/17/13/rBQwP3WVwAAsSb882.jpg",
                "creator": "",
                "status": "VALID",
                "weight": "0.1",
                "created": "2013-11-22 15:25:09",
                "modified": "2014-02-25 15:42:39",
                "desc": "商品描述信息“
                "cubage": "300:150:50",
                "producter": "",
                "wrap": "",
                "service": "",
                "ware_id": 100001,
                "spu_id": 0,
                "cid": 9786,
                "vender_id": 53460,
                "shop_id": 49787,
                "ware_status": "ON_SALE",
                "item_num": "",
                "upc_code": "",
                "transport_id": 0,
                "online_time": "2014-02-25 15:42:38",
                "offline_time": "2014-02-25 15:42:38",
                "cost_price": "0.00",
                "market_price": "232.00",
                "jd_price": "119.00",
                "stock_num": 4,
                "outer_id": "",
                "pack_listing": ""
            }
        ]
    }
}

 

l  SDK调用示例（java）

 

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareListRequest wareListRequest= new WareListRequest();

wareListRequest.setWareIds("1100021758");

wareListRequest.setFields("");

WareListResponse res = client.execute(wareListRequest);

  
8. 检索商品信息

l  接口名称

    

360buy.wares.search


l  功能说明

              

根据商品创建时间、商品价格、商品名称等条件检索商品。


l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

cid 

number

否

 

类目id 

start_price 

number

否

 

最小价格（分）

end_price 

number

否

 

最大价格（分

page 

number

是

 

分页（范围是0至999）

page_size 

number

是

 

每页多少条（范围是0至100）

title 

string

否

 

商品名称

order_by 

string

否

 

排序（默认onlineTime ）(offlineTime,onlineTime)

start_timestring否2011-11-04 15:24:43

起始创建时间

(created)

end_timestring否2011-11-09 15:24:43

结束创建时间

(created)

fieldsstring否ware_id,spu_id需返回的字段列表。可选值：ware结构体中的所有字段；字段之间用","分隔
ware_statusstring否11:在售;2:待售

start_modified

string

否

2013-07-20 17:15:00

起始的修改时间

end_modified

string

否

2013-07-20 17:15:00

起始的结束时间

itemNum string 否   商品货号
parentShopCategoryId string 否 5807 店内分类一级分类
shopCategoryId string 否 5808 店内分类二级分类

返回结果


名称

类型

示例值

描述

wares

List

 

商品信息

total

Number

 

商品数量

code

string

 

0为正常，其它值参见错误代码一览表



Ware结构


名称

类型

示例值

描述

ware_id

number

1100000015

商品ID

spu_id

String

275333

spu ID

cid

number

1589

分类ID 三级类目ID

vender_id

number

20032

商家ID

shop_id

number

12314

店铺ID

ware_status

String

NEVER_UP

商品状态:

NEVER_UP:从未上架,

CUSTORMER_DOWN:自主下架

SYSTEM_DOWN:系统下架

ON_SALE:在售

AUDIT_AWAIT: 待审核

AUDIT_FAIL: 审核不通过

title

String

京东sop衬衫1

商品标题

item_num

String

23424

外部商品编号，对应商家后台"货号"

upc_code

String

6948807910044

UPC编码

transport_id

number

333

运费模板

online_time

String

2011-12-26 16:09:29

最后上架时间

offline_time

String

2011-12-26 16:14:20

最后下架时间

attributes

String

1001:1501^1006:1504

可选属性

cost_price

String

123.13

进货价, 精确到2位小数，单位:元

market_price

String

123.13

市场价, 精确到2位小数，单位:元

jd_price

String

12.13

京东价,精确到2位小数，单位:元

stock_num

number

10

库存

logo

String

1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg

商品的主图

creator

String

路由器

录入人

status

String

Delete

状态：

Invalid:无效

Valid :有效

weight

String

10

重量,单位:公斤

created

String

2011-11-04 15:24:43

WARE_WARE创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

String

2011-11-04 15:34:43

WARE_WARE修改时间

时间格式：yyyy-MM-ddHH:mm:ss

outer_id

String

Af1315

SKU外部ID，对应商家后台"商家skuid"（保留字段）

is_pay_first

Boolean

true

是否先款后货 支付方式 false：非  true：是

is_can_vat

Boolean

true

发票限制： true为限制，false为不限制开增值税发票

is_imported

Boolean

true

是否进口商品： false为否，true为是

is_health_product

Boolean

true

是否保健品： false为否，true为是

is_shelf_life

Boolean

true

是否保质期管理商品, false为否，true为是

shelf_life_days

Integer

999

保质期： 0-99999范围区间

is_serial_no

Boolean

true

是否序列号管理： false为否，true为是

is_appliances_card

Boolean

true

大家电购物卡： false为否，true为是

is_special_wet

Boolean

true

是否特殊液体： false为否，true为是

ware_big_small_model

Integer

2

商品件型： 0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件

ware_pack_type

Integer

2

商品包装： 1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库


   

l  返回示例 

JSON数据格式

{

    "ware_info_by_info_search_response": {

       "code": "0"

        "total": 2,

        "ware_infos": [

            {

                "attributes": "3777:25966^3776:28557^3778:25969^1000000056:1000000163",

                "status": "",

                "transport_id": 0,

                "vender_id": 20032,

                "cid": 1596,

                "ware_id": 1100006775,

                "spu_id": "",

                "shop_id": 16,

                "ware_status": "deleted",

                "title": "33333",

                "item_num": "",

                "upc_code": "",

                "online_time": "2011-12-27 20:44:21",

                "offline_time": "2011-12-27 20:44:46",

                "cost_price": "0.00",

                "market_price": "15.00",

                "jd_price": "10.00",

                "stock_num": 9,

                "logo": "5891/4ff106e1-d545-40a8-baf6-0e51e691eee0.jpg",

                "creator": "",

                "weight": "1.0",

                "created": "2010-10-09 13:44:13",

                "modified": "2011-12-27 20:45:16",

                "outer_id": ""

            },

            {

                "attributes": "3777:25966^3776:28557^3778:25968^1000000056:1000000163",

                "status": "",

                "transport_id": 0,

                "vender_id": 20032,

                "cid": 1596,

                "ware_id": 1100011525,

                "spu_id": "",

                "shop_id": 16,

                "ware_status": "valid",

                "title": "无故",

                "item_num": "",

                "upc_code": "",

                "online_time": "2010-11-02 17:33:03",

                "offline_time": "2010-11-06 09:50:42",

                "cost_price": "0.00",

                "market_price": "3.00",

                "jd_price": "3.00",

                "stock_num": 10000000,

                "logo": "9842/2aeb0a80-93b4-4756-ac9b-3f74899eccaf.jpg",

                "creator": "",

                "weight": "3.0",

                "created": "2010-11-02 17:38:16",

                "modified": "2010-11-06 09:50:42",

                "outer_id": ""

            }

        ],

    }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareInfoByInfoRequest wareInfoByInfoRequest= new WareInfoByInfoRequest();

wareInfoByInfoRequest.setPage("1");

wareInfoByInfoRequest.setPageSize("10");

wareInfoByInfoRequest.setStartPrice("100");

wareInfoByInfoRequest.setEndPrice("1000");

WareInfoByInfoSearchResponse res = client.execute(wareInfoByInfoRequest);

  
9. 获取商品上架的商品信息
  

l  接口名称

    

360buy.ware.listing.get


l  功能说明


     根据商品上架时间、商品类目等条件查询上架的商品信息。


l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

cid

number

否

 

类目id

start_modified

stirng

否

2011-11-01 00:00:00

起始的上架修改时间(online_time)

如不输入，默认返回半年内的上架商品数据

end_modified

stirng

否

2012-11-01 00:00:00

结束的上架修改时间(online_time)

如不输入，默认返回半年内的上架商品数据

page

number

是

 

分页（范围是0至999）

page_size

number

是

 

每页多少条（范围是0至100）

fieldsstring否ware_id,spu_id需返回的字段列表。可选值：ware结构体中的所有字段；字段之间用","分隔


l 返回结果


名称

类型

示例值

描述

wares

List

 

商品信息

total

Number

 

商品数量

code

string

 

0为正常，其它值参见错误代码一览表

 


Ware结构 

名称

类型

示例值

描述

ware_id

number

1100000015

商品ID

spu_id

String

275333

spu ID

cid

number

1589

分类ID 三级类目ID

vender_id

number

20032

商家ID

shop_id

number

12314

店铺ID

ware_status

String

NEVER_UP

商品状态:

NEVER_UP:从未上架,

CUSTORMER_DOWN:自主下架

SYSTEM_DOWN:系统下架

ON_SALE:在售

AUDIT_AWAIT: 待审核

AUDIT_FAIL: 审核不通过

title

String

京东sop衬衫1

商品标题

item_num

String

23424

外部商品编号，对应商家后台“货号”

upc_code

String

6948807910044

UPC编码

transport_id

number

333

运费模板

online_time

String

2011-12-26 16:09:29

最后上架时间

offline_time

String

2011-12-26 16:14:20

最后下架时间

attributes

String

1001:1501^1006:1504

可选属性

cost_price

String

123.13

进货价, 精确到2位小数，单位:元

market_price

String

123.13

市场价, 精确到2位小数，单位:元

jd_price

String

12.13

京东价,精确到2位小数，单位:元

stock_num

number

10

库存

logo

String

1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg

商品的主图

creator

String

路由器

录入人

status

number

Delete

状态：

Delete:删除

Invalid:无效

Valid :有效

weight

String

10

重量,单位:公斤

created

String

2011-11-04 15:24:43

WARE_WARE创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

String

2011-11-04 15:34:43

WARE_WARE修改时间

时间格式：yyyy-MM-ddHH:mm:ss

outer_id

String

Af1315

外部sku_id, 对应商家后台“商家skuid”（保留字段）

is_pay_first

Boolean

true

是否先款后货 支付方式 false：非  true：是

is_can_vat

Boolean

true

发票限制： true为限制，false为不限制开增值税发票

is_imported

Boolean

true

是否进口商品： false为否，true为是

is_health_product

Boolean

true

是否保健品： false为否，true为是

is_shelf_life

Boolean

true

是否保质期管理商品, false为否，true为是

shelf_life_days

Integer

999

保质期： 0-99999范围区间

is_serial_no

Boolean

true

是否序列号管理： false为否，true为是

is_appliances_card

Boolean

true

大家电购物卡： false为否，true为是

is_special_wet

Boolean

true

是否特殊液体： false为否，true为是

ware_big_small_model

Integer

2

商品件型： 0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件

ware_pack_type

Integer

2

商品包装： 1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库

 


l  返回示例

JSON数据格式

 {

  "ware_listing_get_response":{

       "code":"0"

     "total":8,

       "ware_infos":[{

          "attributes":"3205:65528^3206:22106^1000000046:150030147,150030148^1000000041:150030146,150030149",

             "status":"VALID",

             "vender_id":20032,

             "title":"111",

             "cid":1354,

             "cost_price":"0.00",

             "created":"2011-11-01 20:33:06",

             "item_num":"",

             "jd_price":"11.00",

             "ware_status":"ON_SALE",

             "logo":"http://venimg.360buy.net/uploads/popvender/ware/ware/n0/7734/fcbc9665-45d2-4726-8747-158ccfbce9f6.jpg",

             "spu_id":0,

             "market_price":"13.00",

             "modified":"2011-11-01 20:33:06",

             "offline_time":"2011-11-01 20:33:06",

             "online_time":"2011-11-01 20:04:34",

             "outer_id":"",

             "shop_id":16,

             "stock_num":100,

             "upc_code":"",

             "transport_id":0,

             "ware_id":1100024976,

             "weight":"1.0",

             "creator":""

      },

      {

       "attributes":"3205:65528^3206:22106^1000000046:150030147,150030148^1000000041:150030146,150030149",

       "status":"VALID",

       "vender_id":20032,

       "title":"sop>1kg",

       "cid":1354,

       "cost_price":"0.00",

       "created":"2011-11-01 19:56:40",

       "item_num":"",

       "jd_price":"33.00",

       "ware_status":"ON_SALE",

       "logo":"http://venimg.360buy.net/uploads/popvender/ware/ware/n0/9061/f4878734-00dc-4607-9c2c-cc3412177ebe.jpg",

       "spu_id":0,

       "market_price":"33.00",

       "modified":"2011-11-01 19:56:40",

       "offline_time":"2011-11-01 19:56:40",

       "online_time":"2011-11-01 19:28:09",

       "outer_id":"",

       "shop_id":16,

       "stock_num":100,

       "upc_code":"",

       "transport_id":0,

       "ware_id":1100024943,

       "weight":"3.0",

       "creator":""

       }],

       }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareListingGetRequest request = new WareListingGetRequest();

request.setCId("1354");

request.setPage("1");

request.setPageSize("2");

request. setStartTime ("2012-01-23 22:15:29 ");

request. setEndTime ("2012-02-23 22:15:29 ");

WareListingGetResponse response = client.execute(request);

 

  
10. 获取商品下架的商品信息
  

l  接口名称 


 360buy.ware.delisting.get


l  功能说明

 

根据商品下架时间、商品类目等条件查询下架的商品信息。



l  系统级别输入参数


名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.


l  应用级输入参数


名称

类型

是否必须

示例值

描述

cid

number

否

 

类目id

start_modified

stirng

否

2011-11-01 00:00:00

起始的下架修改时间(offline_time)

end_modified

stirng

否

2012-11-01 00:00:00

结束的下架修改时间(offline_time)

page

number

是

 

分页

page_size

number

是

 

每页多少条

fields

string否ware_id,spu_id需返回的字段列表。可选值：ware结构体中的所有字段；字段之间用","分隔


l 返回结果


名称

类型

示例值

描述

wares

List

 

商品信息

total

Number

 

商品数量

code

string

 

0为正常，其它值参见错误代码一览表

 

Ware结构

名称

类型

示例值

描述

ware_id

number

1100000015

商品ID

spu_id

String

275333

spu ID

cid

number

1589

分类ID 三级类目ID

vender_id

number

20032

商家ID

shop_id

number

12314

店铺ID

ware_status

String

NEVER_UP

商品状态:

NEVER_UP:从未上架,

CUSTORMER_DOWN:自主下架

SYSTEM_DOWN:系统下架

ON_SALE:在售

AUDIT_AWAIT: 待审核

AUDIT_FAIL: 审核不通过

title

String

京东sop衬衫1

商品标题

item_num

String

23424

货号

upc_code

String

6948807910044

UPC编码

transport_id

number

333

运费模板

online_time

String

2011-12-26 16:09:29

最后上架时间

offline_time

String

2011-12-26 16:14:20

最后下架时间

attributes

String

1001:1501^1006:1504

可选属性

cost_price

String

123.13

进货价, 精确到2位小数，单位:元

market_price

String

123.13

市场价, 精确到2位小数，单位:元

jd_price

String

12.13

京东价,精确到2位小数，单位:元

stock_num

number

10

库存

logo

String

1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg

商品的主图

creator

String

路由器

录入人

status

number

Delete

状态：

Delete:删除

Invalid:无效

Valid :有效

weight

String

10

重量,单位:公斤

created

String

2011-11-04 15:24:43

WARE_WARE创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

String

2011-11-04 15:34:43

WARE_WARE修改时间

时间格式：yyyy-MM-ddHH:mm:ss

outer_id

String

Af1315

外部id,商家设置的外部id（保留字段）

is_pay_first

Boolean

true

是否先款后货 支付方式 false：非  true：是

is_can_vat

Boolean

true

发票限制： true为限制，false为不限制开增值税发票

is_imported

Boolean

true

是否进口商品： false为否，true为是

is_health_product

Boolean

true

是否保健品： false为否，true为是

is_shelf_life

Boolean

true

是否保质期管理商品, false为否，true为是

shelf_life_days

Integer

999

保质期： 0-99999范围区间

is_serial_no

Boolean

true

是否序列号管理： false为否，true为是

is_appliances_card

Boolean

true

大家电购物卡： false为否，true为是

is_special_wet

Boolean

true

是否特殊液体： false为否，true为是

ware_big_small_model

Integer

2

商品件型： 0免费、1超大件、2超大件半件、3大件、4大件半件、5中件、6中件半件、7小件、8超小件

ware_pack_type

Integer

2

商品包装： 1普通商品、2易碎品、3裸瓶液体、4带包装液体、5按原包装出库


 


l  返回示例

JSON数据格式

 {

  "ware_delisting_get_response":{

        "code":"0"

  "total":9,

  "ware_infos":[

     {"attributes":"3205:65599^3206:22106,22107^1000000046:150028361,150028522^1000000041:150030061",

       "status":"VALID",

       "vender_id":20032,

       "title":"xinzeng",

       "cid":1354,

       "cost_price":"0.00",

       "created":"2012-02-16 14:00:12",

       "item_num":"",

       "jd_price":"33.00",

       "ware_status":"CUSTORMER_DOWN AUDIT_AWAIT",

       "logo":"http://venimg.360buy.net/uploads/popvender/ware/ware/n0/8112/4565dcb9-6773-4f80-8958-d55fca2eec4e.jpg",

       "spu_id":0,

       "market_price":"33.00",

       "modified":"2012-02-23 18:37:14",

       "offline_time":"2012-02-23 18:28:42",

       "online_time":"2012-02-16 13:55:24",

       "outer_id":"",

       "shop_id":16,

       "stock_num":66,

       "upc_code":"",

       "transport_id":0,

       "ware_id":1100029245,

       "weight":"3.0",

       "creator":""

       },

       {

        "attributes":"3205:65556^3206:22106",

        "status":"VALID",

        "vender_id":20032,

        "title":"咨询",

        "cid":1354,

        "cost_price":"0.00",

        "created":"2012-02-16 15:11:40",

        "item_num":"",

        "jd_price":"44.00",

        "ware_status":"CUSTORMER_DOWN AUDIT_AWAIT",

        "logo":"http://venimg.360buy.net/uploads/popvender/ware/ware/n0/6402/76212c51-ec52-4a73-92a1-79833b81aed7.jpg",

        "spu_id":0,

        "market_price":"44.00",

        "modified":"2012-02-23 18:27:52",

        "offline_time":"2012-02-23 18:27:52",

        "online_time":"2012-02-16 15:06:51",

        "outer_id":"",

        "shop_id":16,

        "stock_num":33,

        "upc_code":"",

        "transport_id":0,

        "ware_id":1100029246,

        "weight":"3.0",

        "creator":""

        }],

       }

}


l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareDelistingGetRequest request = new WareDelistingGetRequest();

request.setCId("1354");

request.setPage("1");

request.setPageSize("2");

request. setStartTime ("2012-01-23 22:15:29 ");

request. setEndTime ("2012-02-23 22:15:29 ");

WareDelistingGetResponse response = client.execute(request);

  
11. 根据商品Id，销售属性值Id查询图片

接口名称

360buy.ware.propimgs.get

 功能说明

        通过api 根据商品Id，销售属性值Id查询图片

 系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

 应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

attribute_value_id

String

是

12345

属性值Id(颜色值Id)

fields

String

否

 

可选字段

返回结果

名称

类型

示例值

描述

propimgs

List<WarePropimg>

 

图片信息

total

Number

 

图片信息数量

code

string

 

0为正常，其它值参见错误代码一览表

 

WarePropimg结构

名称

类型

是否必须

示例值

描述

ware_id

String

 

1100000015

商品的id

color_id

String

 

 

颜色id

img_id

String

 

 

图片Id

img_url

String

 

 

图片存储路径

is_main

String

 

 

是否主图

created

String

 

 

修改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

返回示例

JSON数据格式

{

    "ware_propimgs_get_response": {

        "code": "0"

        "total": 3,

        "propimg": [

            {

                "created": "2012-12-05 18:47:21",

                "is_main": "是",

                "ware_id": 1100216256,

                "color_id": "1500368002",

                "img_id": 7625,

                "img_url": "http://img10.360buyimg.com/n5/g1/M00/00/00/CgrhMlC_I-AIAAAAAAMYWnc0ZBcAAAACQJhweUAAxhy991.jpg"

            },

            {

                "created": "2012-12-04 13:53:35",

                "is_main": "否",

                "ware_id": 1100216256,

                "color_id": "1500368002",

                "img_id": 6422,

                "img_url": "http://img10.360buyimg.com/n5/g2/M00/00/00/CgrhNlC9jykIAAAAAAMYWnc0ZBcAAAAYwIQTAYAAxhy694.jpg"

            },

            {

                "created": "2012-12-04 14:35:04",

                "is_main": "否",

                "ware_id": 1100216256,

                "color_id": "1500368002",

                "img_id": 6821,

                "img_url": "http://img10.360buyimg.com/n5/g2/M00/00/00/CgrhNlC9mOMIAAAAAAMYWnc0ZBcAAAAYwKkT6oAAxhy995.jpg"

            }

        ],

    }

}

SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WarePropimgsGetRequest warePropimgGetRequest = new WarePropimgsGetRequest();

warePropimgGetRequest.setWareId("1100216256");

warePropimgGetRequest.setAttributeValueId("1500368002");

warePropimgGetRequest.setFields("img_id,is_main");

WarePropimgsGetResponse warePropimgGetResponse = client.execute(warePropimgGetRequest);

  
12. 根据商品Id，销售属性值Id增加图片

接口名称

360buy.ware.propimg.add

 功能说明

        通过api 根据商品Id，销售属性值Id增加图片

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

 应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

attribute_value_id

String

是

12345

属性值Id(颜色值Id)（如果没有此ID，请输入0000000000）

is_main_pic

Boolean

否

true

是否把当前图片设置为主图

image

Byte[]

是

 

图片数据（注意：签名时不需要添加此参数，image参数通过post 输出流方式发送）图片类型只支持：png和jpg的，图片须800x800的  图，片不能大于1M

 返回结果

名称

类型

是否必须

示例值

描述

ware_id

String

 

1100000015

商品的id

attribute_value_id

String

 

12345

属性值Id(颜色值Id)

id

String

 

 

图片Id

created

String

 

 

更改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

 返回示例

JSON数据格式

{

    "ware_propimg_add_response": {

        "code": "0"

        "id": 7625,

        "created": "2012-12-05 06:40:19",

        "ware_id": 1100216256,

        "attribute_value_id": "1500368002",

    }

}

 SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WarePropimgAddRequest warePropimgUploadRequest = new WarePropimgAddRequest();

warePropimgUploadRequest.setWareId("1100216256");

warePropimgUploadRequest.setAttributeValueId("1500368002");

warePropimgUploadRequest.setMainPic(true);

FileItem fileItem = new FileItem(new File("D:\\321.jpg"));

warePropimgUploadRequest.setImage(fileItem);

WarePropimgAddResponse warePropimgUploadResponse = client.execute(warePropimgUploadRequest);

  
13. 根据商品Id，销售属性值Id删除图片

接口名称

360buy.ware.propimg.delete

功能说明

        通过api 根据商品Id，销售属性值Id删除图片

 系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

 应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

attribute_value_id

String

是

12345

属性值Id(颜色值Id)

image_id

String

是

100

图片Id

返回结果

名称

类型

是否必须

示例值

描述

image_id

String

 

 

图片Id

created

String

 

 

更改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

返回示例

JSON数据格式

{

    "ware_propimg_delete_response": {

        "code": "0"

        "created": "2012-12-05 06:27:53",

        "image_id": "6825",

    }

}

SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WarePropimgDeleteRequest warePropimgDeleteRequest = new WarePropimgDeleteRequest();

warePropimgDeleteRequest.setWareId("1100216256");

warePropimgDeleteRequest.setAttributeValueId("1500368002");

warePropimgDeleteRequest.setImageId("6825");

WarePropimgDeleteResponse warePropimgDeleteResponse = client.execute(warePropimgDeleteRequest);

  
14. 根据商品Id，销售属性值Id设置图片

接口名称

360buy.ware.propimg.update

 功能说明

        通过api 根据商品Id，销售属性值Id设置图片

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

 应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

attribute_value_id

String

是

12345

属性值Id(颜色值Id)

is_main_pic

Boolean

否

true

是否把当前图片设置为主图

image_id

String

是

 

图片Id

 返回结果

名称

类型

是否必须

示例值

描述

image_id

String

 

 

图片Id

created

String

 

 

更改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

  返回示例

  

JSON数据格式

{

    "ware_propimg_update_response": {

        "code": "0"

        "created": "2012-12-05 06:20:33",

        "image_id": "6422",

    }

}

Ø  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WarePropimgUpdateRequest warePropimgUpdateRequest = new WarePropimgUpdateRequest();

warePropimgUpdateRequest.setWareId("1100216256");

warePropimgUpdateRequest.setMainPic(true);

warePropimgUpdateRequest.setImageId("6422");

warePropimgUpdateRequest.setAttributeValueId("1500368002");

WarePropimgUpdateResponse warePropimgUpdateResponse = client.execute(warePropimgUpdateRequest);

 

  
15. 根据商品Id，检索商品主图

接口名称

360buy.ware.propimgs.search

功能说明

根据商品Id，检索商品主图

系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1100000015

商品的id

pagenumber是1分页
page_sizenumber是20每页多少条

fields

String

否

 

可选字段

返回结果

名称

类型

示例值

描述

propimgs

List<WarePropimg>

 

图片信息

total

Number

 

图片信息数量

code

string

 

0为正常，其它值参见错误代码一览表

WarePropimg结构

名称

类型

是否必须

示例值

描述

ware_id

String

 

1100000015

商品的id

color_id

String

 

 

颜色id

img_id

String

 

 

图片Id

img_url

String

 

 

图片存储路径

is_main

String

 

 

是否主图

created

String

 

 

修改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

返回示例

JSON数据格式

{
    "ware_propimgs_search_response": {
        "total": 3,
        "propimg": [
            {
                "created": "2012-12-05 18:47:21",
                "is_main": "是",
                "ware_id": 1100216256,
                "color_id": "1500368002",
                "img_id": 7625,
                "img_url": "http://img10.360buyimg.com/n5/g1/M00/00/00/CgrhMlC_I-AIAAAAAAMYWnc0ZBcAAAACQJhweUAAxhy991.jpg"
            },
            {
                "created": "2012-12-04 13:53:35",
                "is_main": "否",
                "ware_id": 1100216256,
                "color_id": "1500368002",
                "img_id": 6422,
                "img_url": "http://img10.360buyimg.com/n5/g2/M00/00/00/CgrhNlC9jykIAAAAAAMYWnc0ZBcAAAAYwIQTAYAAxhy694.jpg"
            },
            {
                "created": "2012-12-04 14:35:04",
                "is_main": "否",
                "ware_id": 1100216256,
                "color_id": "1500368002",
                "img_id": 6821,
                "img_url": "http://img10.360buyimg.com/n5/g2/M00/00/00/CgrhNlC9mOMIAAAAAAMYWnc0ZBcAAAAYwKkT6oAAxhy995.jpg"
            }
        ],
        "code": "0"
    }
}

SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WarePropimgsSearchRequest warePropimgGetRequest = new WarePropimgsSearchRequest();
warePropimgGetRequest .setWareId("1100216256");
warePropimgGetRequest.setPage("1");
warePropimgGetRequest.setPageSize("20");
WarePropimgsSearchResponse  warePropimgGetResponse = client.execute(warePropimgGetRequest);
  
16. 设置商品限购区域

l  接口名称

360buy.ware.area.limit.update

l  功能说明

设置某个商品的限购区域。

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1311

商品id，必选

type

String

是

 

业务类型 1:限购(目前只支持限购)

levs

String

是

lev1|lev2|lev3

区域层级列表， 1: 省， 2: 市， 3: 区（目前支持1和2）。以|分隔。

lev为area_ids的级别，levs，area_ids，area_fids个数保证一致。

area_fids

String

是

areaFid1|areaFid2|areaFid3

区域父编号列表，以|分隔。

如果设置区域id没有父区域，需用0表示。
levs，area_ids，area_fids个数保证一致

area_ids

String

是

areaId1,areaId11,areaId111|areaId2,areaId22,areaId222

区域编号列表，以|分隔，如果一个区域父编号对应多个区别编号，以英文逗号分隔。

area_ids最小只能到达市一级，不能到达区县级或者乡镇一级。

levs，area_ids，area_fids个数保证一致，区域id获取调用
http://help.jd.com/jos/question-827.html中的接口

l  返回结果

名称

类型

示例值

描述

wareId

long

 

商品编号

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0.

l  返回示例
JSON数据格式


{
"ware_area_limit_update_response": {
"code": "0",
"ware_id": 1100301261
}
}

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareAreaLimitUpdateRequest wareAreaLimitUpdateRequest = new WareAreaLimitUpdateRequest();
wareAreaLimitUpdateRequest.setWareId("1100301261");
wareAreaLimitUpdateRequest.setLevs("2|1"); /** 市|省 */
wareAreaLimitUpdateRequest.setType("1"); /** 成都市id|北京市id */
wareAreaLimitUpdateRequest.setAreaIds("2801,2802,72,2810|14"); /** 四川省id|省id */”
wareAreaLimitUpdateRequest.setAreaFids("1|0");
WareAreaLimitUpdateResponse res =
client.execute(wareAreaLimitUpdateRequest);
  
17. 查询商品限购区域

l  接口名称

360buy.ware.area.limit.search

l  功能说明

查询某个商品的限购区域。

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

String

是

1311

商品id，必选

type

String

是

 

业务类型,1:限购，目前只支持限购

fields

String

否

 

商家希望返回的限购区域的信息字段, 可选值: WareAreaLimit数据结构中的以下字段:
order_id,vender_id, area_fid等每个字段以逗号分隔

l  返回结果

ware_area_limits

List< WareAreaLimit>

 

商品限购区域信息

total

int

  

限购区域总的记录数

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0

WareAreaLimit结构


名称

类型

示例值

描述

ware_id

Long

1100000015 L

商品ID

vender_id

Long

20032 L

商家ID

area_fid

Int

12314

区域父id，如果当前区域id无父区域id，用0表示。

lev

Int

1

区域级别，1: 省，2:市，3:区

type

Int

京东sop衬衫1

业务类型，1:限购

area_ids

String

23424

区域id，同一个省下的不同城市使用英文逗号(,)分隔

created

String

6948807910044

创建日期

modified

String

333

修改日期

 l  返回示例
JSON数据格式

{
"ware_area_limit_search_response": {
"code": "0",
"total": 5,
"ware_area_limits": [
{
"lev": 1,
"type": 1,
"created": "2013-08-29 00:00:00",
"modified": "2013-08-29 00:00:00",
"ware_id": 1100301261,
"vender_id": 20032,
"area_fid": 0,
"area_ids": "1"
},
{
"lev": 1,
"type": 1,
"created": "2013-08-29 00:00:00",
"modified": "2013-08-29 00:00:00",
"ware_id": 1100301261,
"vender_id": 20032,
"area_fid": 0,
"area_ids": "2"
},
{
"lev": 1,
"type": 1,
"created": "2013-08-29 00:00:00",
"modified": "2013-08-29 00:00:00",
"ware_id": 1100301261,
"vender_id": 20032,
"area_fid": 0,
"area_ids": "3"
},
{
"lev": 1,
"type": 1,
"created": "2013-08-29 00:00:00",
"modified": "2013-08-29 00:00:00",
"ware_id": 1100301261,
"vender_id": 20032,
"area_fid": 0,
"area_ids": "4"
},
{
"lev": 2,
"type": 1,
"created": "2013-08-29 00:00:00",
"modified": "2013-08-29 00:00:00",
"ware_id": 1100301261,
"vender_id": 20032,
"area_fid": 6,
"area_ids": "379,398,309"
}
]
}
}

l  SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareAreaLimitSearchRequest wareAreaLimitSearchRequest = new WareAreaLimitSearchRequest();
wareAreaLimitSearchRequest.setType("1");
wareAreaLimitSearchRequest.setWareId("1100301261");
WareAreaLimitSearchResponse res =
client.execute(wareAreaLimitSearchRequest);
18. 添加关联版式

接口名称
360buy.ware.template.add


功能说明
添加商品关联版式。


系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

应用级输入参数

名称

类型

是否必须

示例值

描述

name

String

是

“版式1”

关联版式名称，最大10个字符,必选

contents

String[]

是

["顶部内容所需要输入的内容，例如：

花好月圆

",null]

顶部模板与底部模板分别最大字符是10000个字符, 格式:{"顶部内容所需要输入的内容，例如：

花好月圆

","底部所需要输入的内容,例如：

阴晴圆缺

"},

如果只添加顶部内容,格式:{"顶部内容所需要输入的内容，例如：

花好月圆

",null};

如果只添加底部内容，格式:{null,"底部所需要输入的内容,例如：

阴晴圆缺

"};

返回结果

名称 类型 示例值 描述

id

Long

版式id

code

String


返回错误code，如果能够正常返回结果则code=0，否则code!=0

返回示例
JSON数据格式


{
"ware_template_add_response": {
"code": "0",
"id": 9022
}
}

SDK调用示例（java）

public JdClient client = newDefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);

WareTemplateAddRequest request = newWareTemplateAddRequest();request.setName("关联版式1222");

String []contents={"顶部内容所需要输入的内容，例如：

花好月圆

",null};

request.setContents(contents);

WareTemplateAddResponseresponse = client.execute(request);

19. 修改关联版式

接口名称
360buy.ware.template.update


功能说明
修改商品关联版式。


系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

应用级输入参数

名称

类型

是否必须

示例值

描述

id

String

是

“112312”

版式id,123

name

String

名称与内容必须传一个

“版式1”

关联版式名称，最大10个字符,必选

contents

String[]

名称与内容必须传一个

["顶部内容所需要输入的内容，例如：

花好月圆

",null]

顶部模板与底部模板分别最大字符是10000个字符。

格式：{"顶部内容所需要输入的内容，例如：

花好月圆

"，"底部所需要输入的内容,例如：

阴晴圆缺

"}

如果只修改顶部内容，格式："{顶部内容所需要输入的内容，例如：

花好月圆

",null}；

如果只修改底部内容，格式：{null,"底部所需要输入的内容,例如：

阴晴圆缺

"}；

如果只需要将顶部内容修改null，格式：{"","底部所需要输入的内容,例如：

阴晴圆缺

"}；

如果只需要将底部内容修改nul，格式：{"顶部内容所需要输入的内容，例如：

花好月圆

",""};

返回结果

名称 类型 示例值 描述

id

Long

  

版式id

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0

返回示例
JSON数据格式


{
"ware_template_update_response": {
"code": "0",
"id": 8905
}
}

SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareTemplateUpdateRequest request = new WareTemplateUpdateRequest();
request.setId(8905+"");
String []contents={"大飞爱否",null};
request.setContents(contents);
WareTemplateUpdateResponse response = client.execute(request);

20. 删除关联版式

接口名称
360buy.ware.template.delete


功能说明 

删除商品关联版式。


系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

应用级输入参数

名称

类型

是否必须

示例值

描述

id

String

是

“112312”

版式id,123

返回结果

名称 类型 示例值 描述

id

Long

  

版式id

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0

返回示例
JSON数据格式


{
"ware_template_delete_response": {
"code": "0",
"id": 8905
}
}

SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareTemplateDeleteRequest request = new WareTemplateDeleteRequest();
request.setId("8905");
WareTemplateDeleteResponse response = client.execute(request);

21. 查询关联版式id以及名称

接口名称
360buy.ware.template.ids.names.get


功能说明
查询 关联版式id以及名称。


系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

fields

String

否

 

需返回的字段列表。可选值：WareTemplate结构体中的所有字段；字段之间用","分隔

返回结果

名称 类型 示例值 描述

ware_templates

List< WareTemplate >

  

关联版式集合

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0

WareTemplate结构

名称

类型

示例值

描述

id

Long

115 L

版式ID

name

String

12314

版式名称

 返回示例
JSON数据格式


{
"ware_template_ids_names_get_response": {
"code": "0",
"ware_templates": [
{
"id": 3966,
"name": "版式111"
},
{
"id": 9022,
"name": "关联版式1222"
},
{
"id": 9023,
"name": "关联版式112322"
}
]
}
}

SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareTemplateIdsAndNamesGetRequest request = new WareTemplateIdsAndNamesGetRequest();
WareTemplateIdsAndNamesGetResponse response = client.execute(request);

22. 查询关联版式详情

接口名称
360buy.ware.template.get


功能说明
查询关联版式详情。


系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

应用级输入参数

名称

类型

是否必须

示例值

描述

id

String

是

“112312”

版式id,123

fields

String

否

 

需返回的字段列表。可选值：WareTemplate结构体中的所有字段；字段之间用","分隔

返回结果

名称 类型 示例值 描述

ware_template

WareTemplate

  

关联版式信息

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0

WareTemplate结构


名称

类型

示例值

描述

id

Long

115 L

版式ID

vender_id

Long

20032 L

商家ID

name

String

12314

版式名称

contents

String[]

[“顶部内容”,”底部内容”]

版式内容, 列表顺序即为模板的顶部和底部，其中[0]表示顶部,[1],表示底部

 返回示例
JSON数据格式


{

"ware_template_get_response":{

"code": "0",

"ware_template": {

"id": 9022,

"name": "关联版式1222",

"contents": [

"顶部内容所需要输入的内容，例如：<br/><H3>花好月圆</H3>",

null

],

"vender_id": 20032

}

}

}

SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareTemplateGetRequest request = new WareTemplateGetRequest();
request.setId(9022+"");
WareTemplateGetResponse response = client.execute(request);

23. 设置/取消商品的关联版式

接口名称
360buy.ware.template.to.wares.update


功能说明
设置、修改、取消关联版式到商品。


系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format

String

否

暂时只支持json

v

String

是

API协议版本，可选值:2.0.

应用级输入参数

名称

类型

是否必须

示例值

描述

id

String

是

“112312”

版式id,123

取消商品关联版式时，请将此字段值设置为空

ware_ids

String

是

“123313,12312123”

商品编号集合，最大不超过20个

返回结果

名称 类型 示例值 描述

code

String

 

返回错误code，如果能够正常返回结果则code=0，否则code!=0

返回示例
JSON数据格式


{
"ware_template_to_wares_update_response": {
"code": "0"
}
}

SDK调用示例（java）


public JdClient client = new DefaultJdClient(SERVER_URL,
"c7b82199-f26d-459e-a4b3-d6f6cec4b869",”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);
WareTemplateToWaresUpdateRequest request = new WareTemplateToWaresUpdateRequest();
request.setId(9033+"");
request.setWareIds("1100304115,1100303940");
WareTemplateToWaresUpdateResponse response = client.execute(request);


返回顶部