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. 设置关联版式到商品 |
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_location | string | 否 | 北京 | 产地 |
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_pids | String | 所选pid输入类型等于3,pid是必须输入 | 1132632|12142|876231 | 用户自行输入的类目属性ID串结构:"pid1|pid2|pid3", 属性的pid调用360buy.ware.get.attribute取得, 输入类型input_type=3即输入 |
input_strs | String | 内容1|内容2|内容3 | 用户自行输入的属性值,结构:"输入值|输入值2|输入值3" 图书品类输入值规则: ISBN:数字、字母格式 | |
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天内。 |
l 返回结果
名称 | 类型 | 是否必须 | 示例值 | 描述 |
created | String |
|
| 更改时间 |
ware_id | long |
|
| 商品的id |
skus | List< 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); |
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_location | String | 否 | 北京 | 产地 |
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_pids | String | 所选pid输入类型等于3,pid是必须输入 | 1132632|12142|876231 | 用户自行输入的类目属性ID串结构:"pid1|pid2|pid3", 属性的pid调用360buy.ware.get.attribute取得, 输入类型input_type=3即输入 |
input_strs | String | 内容1|内容2|内容3 | 用户自行输入的属性值,结构:"输入值|输入值2|输入值3 图书品类输入值规则: | |
stock_num | String | 否 | 库存数(针对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 |
skus | List< 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": [ } } |
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); |
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); |
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); |
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); |
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 | 自定义店内分类 | |
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);
|
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 |
| 商品信息 |
total | int | 总记录数 | |
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 | 自定义店内分类 | |
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); |
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_time | string | 否 | 2011-11-04 15:24:43 | 起始创建时间 (created) |
end_time | string | 否 | 2011-11-09 15:24:43 | 结束创建时间 (created) |
fields | string | 否 | ware_id,spu_id | 需返回的字段列表。可选值:ware结构体中的所有字段;字段之间用","分隔 |
ware_status | string | 否 | 1 | 1:在售;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); |
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) |
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 | 外部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)
|
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); |
接口名称
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); |
接口名称
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); |
接口名称
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); |
接口名称
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); |
接口名称
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 |
page | number | 是 | 1 | 分页 |
page_size | number | 是 | 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); |
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表示。 |
area_ids | String | 是 | areaId1,areaId11,areaId111|areaId2,areaId22,areaId222 | 区域编号列表,以|分隔,如果一个区域父编号对应多个区别编号,以英文逗号分隔。 area_ids最小只能到达市一级,不能到达区县级或者乡镇一级。 levs,area_ids,area_fids个数保证一致,区域id获取调用 |
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); |
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数据结构中的以下字段: |
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); |
接口名称
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); |
接口名称
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); |
接口名称
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); |
接口名称
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); |
接口名称
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); |
接口名称
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); |