文档中心> 开发文档> 接口列表> 图书商品API> dangdang.item.search
dangdang.item.add
添加商品
dangdang.item.update
修改商品
dangdang.item.get
获取单个商品信息
dangdang.item.delete
删除商品信息
dangdang.item.search
获取商品列表信息
dangdang.item.stock....
库存修改
dangdang.item.update...
库存修改(支持地区仓)
dangdang.item.price....
价格更新
dangdang.item.status...
设置商品状态
dangdang.item.postag...
设置商品运费
dangdang.item.cod.up...
设置是否支持cod
dangdang.item.bestpa...
查询商品最佳拍档
dangdang.item.bastPa...
设置商品最佳拍档
dangdang.item.column...
查询公共栏目
dangdang.item.column...
设置商品公共栏目
dangdang.item.stock....
库存查询(支持地区仓)
dangdang.item.stock....
增量更新库存(支持地...
dangdang.custom.getI...
通过商家标识符获取商...
dangdang.custom.getO...
通过商品标识符获取商...
dangdang.custom.stoc...
通过商家标识符更新库...
dangdang.custom.pric...
通过商家标识符更新价...
系统级输入参数:
请参考系统级输入参数
应用级输入参数:
参数名称
参数类型
是否必填
示例值
参数说明
gShopID
Number
是
489
店铺ID。
check_status
String
否
8990
审核状态查询内容分别为8990:审核通过8991:待审核8992:审核未通过默认值为“审核通过”。
item_id
String
否
12345698
商品标识符商品标识符支持多个查询说明:支持多个查询,中间用“;”隔开。
out_id
string
否
123star
企业商品标识符
item_name
string
否
联想电脑
商品名称
status
Number
否
9997
商品状态。共11种:9999:全部9997:上架0:可销售(预设值)3:不可销售9998:下架6:商家下架1:举报下架4:到期下架5:强制下架7:推荐下架8:临时下架(注:7和8目前没有用到,作为扩展)说明:上架状态的商品含“可销售”和“不可销售”商品,下架状态商品含“商家下架”、“举报下架”、“到期下架”、“强制下架”、“推荐下架”、“临时下架”的商品。
category_id
Number
否
51332
当当分类ID(只支持按末级分类查询)。
shop_category_id
Number
否
230000
店内分类编号。可以查询出属于该店内分类编号的商品。
is_cod
Number
否
9999
是否支持COD。查询内容分别为9999:全部1:是 0:否默认值为“全部”。
item_type
string
否
9999
商品类型。查询内容分别为9999:全部9996:商品 9995:赠品9994:预售品默认值为“全部”。
mts
string
否
2015-05-29 00:00:00
最后修改时间开始。可以查询出修改时间之后的商品。格式为:yyyy-MM-dd HH:mm:ss或yyyy-MM-dd(此时系统默认参数为yyyy-MM-dd 00:00:00)。
mte
string
否
2015-05-29 23:59:59
最后修改时间结束。可以查询出修改时间之前的商品。格式为:yyyy-MM-dd HH:mm:ss或yyyy-MM-dd(此时系统默认参数为yyyy-MM-dd 23:59:59)。
slv
Number
否
5
库存数量最低值。可以查询出库存数量大于等于最低值的商品。
shv
Number
否
900
库存数量最高值。可以查询出库存数量小于等于最高值的商品。
pageSize
Number
否
5
每页结果数量。只能选择如下数值:5、10、15、20可以不填,默认是20。
p
Number
否
3
页数。预设值为1。
XML数据格式:
01
|
<? xmlversion = "1.0" encoding = "GBK" standalone = "yes" ?>
|
02
|
< response >
|
03
|
< functionId >items-search</ functionId >
|
04
|
< result >true</ result >
|
05
|
< resultCode >0</ resultCode >
|
06
|
< resultMessage >查询商品列表成功</ resultMessage >
|
07
|
< totalInfo >
|
08
|
< itemsCount >64</ itemsCount >
|
09
|
< pageSize >20</ pageSize >
|
10
|
< pageTotal >4</ pageTotal >
|
11
|
< currentPage >1</ currentPage >
|
12
|
</ totalInfo >
|
13
|
< items >
|
14
|
< item >
|
15
|
< item_id >1012112824</ item_id >
|
16
|
< item_name >汉子刷卡蒂</ item_name >
|
17
|
< out_id >123456</ out_id >
|
18
|
< isbn >123456789</ isbn >
|
19
|
< sale_price >123.0</ sale_price >
|
20
|
< stock >123</ stock >
|
21
|
< shop_category_ids >0100000,0090000,0020000</ shop_category_ids >
|
22
|
< status >0</ status >
|
23
|
< updateTime >2015-01-04 14:31:45</ updateTime >
|
24
|
< item_type >1</ item_type >
|
25
|
< check_status >8990</ check_status >
|
26
|
< publisher >机械工业出版社</ publisher >
|
27
|
</ item >
|
28
|
< item >
|
29
|
< item_id >1012290524</ item_id >
|
30
|
< item_name >家用电器>> second家电-李文燕用>>三级家电>> four家电-李文燕用>>五级家电-李文燕用</ item_name >
|
31
|
< out_id >123457</ out_id >
|
32
|
< isbn >图书>>艺术>>雕塑</ isbn >
|
33
|
< sale_price >123.0</ sale_price >
|
34
|
< stock >123</ stock >
|
35
|
< shop_category_ids />
|
36
|
< status >3</ status >
|
37
|
< updateTime >2015-01-04 14:23:22</ updateTime >
|
38
|
< item_type >0</ item_type >
|
39
|
< check_status >8990</ check_status >
|
40
|
< publisher >图书>>艺术>>雕塑</ publisher >
|
41
|
</ item >
|
42
|
</ items >
|
43
|
</ response >
|
JSON数据格式:
01
|
{
|
02
|
"response" : {
|
03
|
"result" : true ,
|
04
|
"items" : {
|
05
|
"item" : [
|
06
|
{
|
07
|
"stock" : 123,
|
08
|
"sale_price" : 123,
|
09
|
"check_status" : 8990,
|
10
|
"updateTime" : "2015-01-04 14:31:45" ,
|
11
|
"status" : 0,
|
12
|
"item_name" : "汉子刷卡蒂" ,
|
13
|
"item_id" : 1012112824,
|
14
|
"out_id" : 123456,
|
15
|
"isbn" : 123456789,
|
16
|
"shop_category_ids" : "0100000,0090000,0020000" ,
|
17
|
"publisher" : "机械工业出版社" ,
|
18
|
"item_type" : 1
|
19
|
},
|
20
|
{
|
21
|
"stock" : 123,
|
22
|
"sale_price" : 123,
|
23
|
"check_status" : 8990,
|
24
|
"updateTime" : "2015-01-04 14:23:22" ,
|
25
|
"status" : 3,
|
26
|
"item_name" : "家用电器 >> second家电-李文燕用>> 三级家电 >> four家电-李文燕用>> 五级家电-李文燕用" ,
|
27
|
"item_id" : 1012290524,
|
28
|
"out_id" : 123457,
|
29
|
"isbn" : "图书 >> 艺术 >> 雕塑" ,
|
30
|
"shop_category_ids" : "" ,
|
31
|
"publisher" : "图书 >> 艺术 >> 雕塑" ,
|
32
|
"item_type" : 0
|
33
|
}
|
34
|
]
|
35
|
},
|
36
|
"resultCode" : 0,
|
37
|
"resultMessage" : "查询商品列表成功" ,
|
38
|
"functionId" : "items-search" ,
|
39
|
"totalInfo" : {
|
40
|
"itemsCount" : 64,
|
41
|
"pageTotal" : 4,
|
42
|
"pageSize" : 20,
|
43
|
"currentPage" : 1
|
44
|
}
|
45
|
}
|
46
|
}
|
java版 |
SdkClient
sdkClient= new SdkClient(appKey, appSecret, session, version) ; |
php版 |
$sdkClient = new DDHttpClient(appKey,appSecret,session) |
Copyright © 当当网 2004-2012, All Rights Reserved