dangdang.item.search

获取商品列表信息

  • 此接口用于商家获取商品列表

    支持的数据格式:XML

    HTTP请求方式:GET

    版本:3.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

    参数名称
    参数类型
    是否必填
    示例值
    参数说明
    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) ;
    PublicationItemListSearchRequest request=new PublicationItemListSearchRequest();
    PublicationItemListSearch itemListSearch=new PublicationItemListSearch();
    itemListSearch.setItem_id("1393047703");
    request.setItemListSearch(itemListSearch);
    PublicationItemListSearchResponse response =sdkClient.excute(request);
    System.out.println(response.toString());


    php版

    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $publicationItemSearchRequest = new PublicationItemSearchRequest();
    $publicationItemSearchRequest->setGShopID("489");
    $sdkResponse = $sdkClient->execute($publicationItemSearchRequest);