dangdang.item.get

获取单个商品信息

  • 此接口用于查询商品详细信息

    支持的数据格式:XML

    HTTP请求方式:GET

    版本:3.0

  • 系统级输入参数:

    请参考系统级输入参数

    应用级输入参数:

    参数名称
    参数类型
    是否必填
    示例值
    参数说明
    fields Field List item_id,stock,item_name,is_cod 需要返回的商品对象字段,如title,price,desc_modules等。可选值:Item商品结构体中所有字段均可返回;多个字段用“,”分隔。
    item_id Number 38382934 商品数字ID
    gShopID Number 489 店铺id

  • XML数据格式:

    01 <?xml version="1.0" encoding="GBK" standalone="yes"?>
    02 <response>
    03     <functionId>item-get</functionId>
    04     <result>true</result>
    05     <resultCode>0</resultCode>
    06     <resultMessage>操作成功</resultMessage>
    07     <time>2014-12-31 11:41:00</time>
    08     <item>
    09         <item_id>1012288024</item_id>
    10         <item_name>商品名称</item_name>
    11         <item_category_id>11561</item_category_id>
    12         <shop_category_ids>0010000,0010001,0010002,0010003</shop_category_ids>
    13         <stock>123</stock>
    14         <market_price>123.0</market_price>
    15         <sale_price>123.0</sale_price>
    16         <purchase_price>123.0</purchase_price>
    17         <item_descs>
    18             <detail>商品详情</detail>
    19             <editor_recomm>编辑推荐</editor_recomm>
    20             <content_recomm>内容推荐</content_recomm>
    21             <catalog>目录</catalog>
    22             <digest>精彩书摘</digest>
    23             <author_intro>作者简介</author_intro>
    24             <preface>前言</preface>
    25             <media_comment>媒体评论</media_comment>
    26             <illustration>书摘与插画</illustration>
    27         </item_descs>
    28         <best_partners>1012112824|1,1012270124|2</best_partners>
    29         <is_cod>1</is_cod>
    30         <is_shop_vip>1</is_shop_vip>
    31         <status>0</status>
    32         <item_type>0</item_type>
    33         <volume>1.0</volume>
    34         <weight>1.0</weight>
    35         <category_attribs>
    36             <isbn>123456789</isbn>
    37             <author>作者</author>
    38             <publisher>机械工业出版社</publisher>
    39             <publish_date>2014-12-31</publish_date>
    40             <size>16开</size>
    41             <is_suit>1</is_suit>
    42             <version>1</version>
    43             <paper_quality>胶版纸</paper_quality>
    44             <print_copy>2</print_copy>
    45             <binding>平装</binding>
    46             <print_date>2006-12-07</print_date>
    47             <is_pinyin>0</is_pinyin>
    48             <words_num>100000</words_num>
    49             <pages_num>50</pages_num>
    50             <present_num>0</present_num>
    51             <print_paper>12</print_paper>
    52             <main_book_name>主书名</main_book_name>
    53             <copies_num>12</copies_num>
    54             <original_book_mame>原版书名</original_book_mame>
    55             <language>中文(简体)</language>
    56             <cbl_category>123456</cbl_category>
    57             <editor>编者</editor>
    58             <translator>译者</translator>
    59             <painter>绘者</painter>
    60         </category_attribs>
    61         <standard_attribs>测试:测试1,测试:测试2,测试:测试3</standard_attribs>
    62         <postage>0</postage>
    63         <check_status>1</check_status>
    64         <pic_urls>
    65             <pic_url>http://img34.ddimg.cn/55/29/1012288024-1_o.jpg</pic_url>
    66             <pic_url>http://img34.ddimg.cn/55/29/1012288024-2_o.jpg</pic_url>
    67         </pic_urls>
    68     </item>
    69 </response>

    JSON数据格式:

    01 {
    02     "response": {
    03         "result"true,
    04         "time""2014-12-31 11:42:46",
    05         "item": {
    06             "best_partners""1012112824|1,1012270124|2",
    07             "pic_urls": {
    08                 "pic_url": [
    09                     "http://img34.ddimg.cn/55/29/1012288024-1_o.jpg",
    10                     "http://img34.ddimg.cn/55/29/1012288024-2_o.jpg"
    11                 ]
    12             },
    13             "weight": 1,
    14             "sale_price": 123,
    15             "check_status": 1,
    16             "status": 0,
    17             "item_descs": {
    18                 "editor_recomm""编辑推荐",
    19                 "media_comment""媒体评论",
    20                 "preface""前言",
    21                 "detail""商品详情",
    22                 "catalog""目录",
    23                 "content_recomm""内容推荐",
    24                 "illustration""书摘与插画",
    25                 "author_intro""作者简介",
    26                 "digest""精彩书摘"
    27             },
    28             "postage": 0,
    29             "purchase_price": 123,
    30             "is_cod": 1,
    31             "stock": 123,
    32             "market_price": 123,
    33             "item_name""商品名称",
    34             "item_id": 1012288024,
    35             "item_category_id": 11561,
    36             "category_attribs": {
    37                 "original_book_mame""原版书名",
    38                 "publish_date""2014-12-31",
    39                 "words_num": 100000,
    40                 "pages_num": 50,
    41                 "is_pinyin": 0,
    42                 "cbl_category": 123456,
    43                 "paper_quality""胶版纸",
    44                 "publisher""机械工业出版社",
    45                 "size""16开",
    46                 "version": 1,
    47                 "print_copy": 2,
    48                 "author""作者",
    49                 "editor""编者",
    50                 "copies_num": 12,
    51                 "translator""译者",
    52                 "main_book_name""主书名",
    53                 "print_paper": 12,
    54                 "isbn": 123456789,
    55                 "binding""平装",
    56                 "painter""绘者",
    57                 "language""中文(简体)",
    58                 "present_num": 0,
    59                 "is_suit": 1,
    60                 "print_date""2006-12-07"
    61             },
    62             "volume": 1,
    63             "standard_attribs""测试:测试1,测试:测试2,测试:测试3",
    64             "is_shop_vip": 1,
    65             "shop_category_ids""0010000,0010001,0010002,0010003",
    66             "item_type": 0
    67         },
    68         "resultCode": 0,
    69         "resultMessage""操作成功",
    70         "functionId""item-get"
    71 }

  • java版

    SdkClient sdkClient= new SdkClient(appKey, appSecret, session, version) ;
    PublicationItemGetRequest request=new PublicationItemGetRequest();
    PublicationItemGet itemGet=new PublicationItemGet();
    itemGet.setItem_id("1393047703");
    request.setItemGetReq(itemGet);
    PublicationItemGetResponse response=sdkClient.excute(request);
    System.out.println(response.toString());


    php版
    $sdkClient = new DDHttpClient(appKey,appSecret,session)
    $publicationItemGetRequest = new PublicationItemGetRequest();
    $publicationItemGetRequest->setItemId("1131210824");
    $sdkResponse = $sdkClient->execute($publicationItemGetRequest);