taobao.fenxiao.product.image.upload (产品图片上传)

产品主图图片空间相对路径或绝对路径添加或更新,或者是图片上传。如果指定位置的图片已存在,则覆盖原有信息。如果位置为1,自动设为主图;如果位置为0,表示属性图片

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 必须 123 产品ID
pic_path String 可选 i3/T1xVXXXkUmudJGow32_043950.jpg 产品主图图片空间相对路径或绝对路径
image byte[] 可选 我是被上传的文件内容 产品图片
position Number 必须 1 图片位置,0-14之间。0:操作sku属性图片,1:主图,2-5:细节图,6-14:额外主图
properties String 可选 1627207:3232484 properties表示sku图片的属性。key:value形式,key是pid,value是vid。如果position是0的话,则properties需要是必传项

响应参数

名称 类型 示例值 描述
result Boolean true 操作是否成功
created Date 2000-01-01 00:00:00 操作时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoProductImageUploadRequest req = new FenxiaoProductImageUploadRequest();
req.setProductId(123L);
req.setPicPath("i3/T1xVXXXkUmudJGow32_043950.jpg");
req.setImage(new FileItem("/tmp/file.txt"));
req.setPosition(1L);
req.setProperties("1627207:3232484");
FenxiaoProductImageUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fenxiao_product_image_upload_response>
    <result>true</result>
    <created>2000-01-01 00:00:00</created>
</fenxiao_product_image_upload_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:image 图片格式或大小错误 图片格式,小于500K

API工具

如何获得此API

FAQ

返回
顶部