当当网开放平台系统
登录 设置个人信息
搜索热词:

文档中心> 开发文档> 接口列表> 图片API> dangdang.items.pics....

返回图片API

dangdang.items.pics.set(百货)

上传商品图片

  • 接口概述

    [隐藏]

    功能描述：商家可以批量上传商品相关图片。每个商品最多上传8张图片；如果该商品在上传之前已经存在图片，那么系统会将原图片全部删除，再发布新图片。若商品的销售属性含“颜色”，那么每种颜色最多上传1张图片；如果某颜色在上传之前已经存在图片，那么系统会将原图片全部删除，再发布新图片。每张图片大小请限定在300k (建议800px*800px，图片的尺寸不能小于300*300px)以内，jpg或gif格式(不支持中文档名)。一个rar文件，最大20M。

    支持的数据格式：XML

    HTTP请求方式：POST

    版本：2.0

  • 提交参数

    [隐藏]

    系统级输入参数：

    请参考系统级输入参数

    应用级输入参数：


    变量名称 变量命名 变量类型 是否必填 示例 说明

    zip文件

    setItemsPics

    file

    是

    pic.zip

    		zip文件(最大20M)　包含：
    1、XML文件：详见“商品图片XML文件说明”
    2、若干图片文件


     

    商品图片XML文件格式说明：

  • 提交示例

    [隐藏]

    商品图片XML文件示例：

    <?xml version="1.0" encoding="GBK"?>

    <request>

     <functionID>dangdang.items.pics.set</functionID>

     <time>2009-03-20 15:10:50</time>

     <PicsList>

      <ProductPicsInfo>  

       <itemID>130828857</itemID>

       <productPic1>130828857name01.jpg</productPic1>

       <productPic2>130828857name02.jpg</productPic2>

       <productPic3>130828899name03.jpg </productPic3>

       <productPic4>130828857name04.jpg</productPic4>

       <productPic5>130828899name05.jpg</productPic5>

       <productPic6>130828899name06.jpg </productPic6>

       <productPic7>130828857name07.jpg</productPic7>

       <productPic8>130828899name08.jpg</productPic8>

       <SpecialPicList>

        <SpecialPicInfo>

         <specialAttributeValue>军绿</specialAttributeValue>

         <ItemPic>130828857_item01.jpg</ItemPic>

        </SpecialPicInfo>

        <SpecialPicInfo>

         <specialAttributeValue>墨绿</specialAttributeValue>

         <ItemPic>130828857_item02.jpg</ItemPic>

        </SpecialPicInfo>

       </SpecialPicList>

      </ProductPicsInfo>

      <ProductPicsInfo>

       <itemID>130828899</itemID>

       <productPic1>130828899name01.jpg </productPic1>

       <productPic2>130828899name02.jpg </productPic2>

       <productPic3>130828899name03.jpg </productPic3>

       <productPic4>130828833name04.jpg</productPic4>

       <productPic5>130828833name05.jpg</productPic5>

      </ProductPicsInfo>

     </PicsList>

    </request>

     

  • 返回参数

    [隐藏]

    商家接收到的XML文件格式说明：

  • 返回示例

    [隐藏]

    商家接收到的XML文件实例：

    <?xml version="1.0" encoding="GBK" ?>

    <response>

     <functionID>dangdang.items.pics.set</functionID>

     <time>2009-05-20 16:39:57</time>

     <ItemsIDList>

      <itemIDInfo>

       <itemID>400306498</itemID>

       <operCode>0</operCode>

       <operation>操作成功</operation>

      </itemIDInfo>

      <itemIDInfo>

      ……

      </itemIDInfo>

     </ItemsIDList>

    </response>

     

  • sdk调用示例

    [隐藏]


    java版

    SdkClient sdk= new SdkClient(appKey, appSecret, session, version) ;
    ProductPictureUploadRequest request=new ProductPictureUploadRequest();
    request.setSetItemsPicsFile(new FileItem(new File(path)));
    ProductPictureUploadResponse response=sdk.excute(request);
    System.out.println( response.toString());


    php版

    $sdkClient = new DDHttpClient(appkey,appSecret,session);
    $ItemsPicsSetRequest = new ItemsPicsSetRequest();
    $ItemsPicsSetRequest->setSetItemsPics($xmlFile);
    $sdkResponse = $sdkClient->execute($ItemsPicsSetRequest);



Copyright © 当当网 2004-2012, All Rights Reserved