taobao.item.propimg.upload.tmall (添加或修改天猫商品属性图片)

添加一张商品属性图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用户 图片的属性必须要是颜色的属性,这个在前台显示的时候需要和sku进行关联的 商品属性图片只有享有服务的卖家(如:淘宝大卖家、订购了淘宝多图服务的卖家)才能上传 商品属性图片有数量和大小上的限制,最多不能超过24张(每个颜色属性都有一张)。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
num_iid Number 必须 123456 商品数字ID,必选
id Number 可选 123456 属性图片ID。如果是新增不需要填写
properties String 必须 1627207:28326 属性列表。调用taobao.itemprops.get获取类目属性,属性必须是颜色属性,再用taobao.itempropvalues.get取得vid。格式:pid:vid。
position Number 可选 122
  • 默认值:0
  • 图片位置
    image byte[] 可选 我是被上传的文件内容
  • 最大长度:3145728
  • 属性图片内容。类型:JPG,GIF;图片大小不超过:3M

    响应参数

    名称 类型 示例值 描述
    prop_img PropImg PropImg属性图片结构
    • └ id
    • Number
    • 1646146
    • 属性图片的id,和商品相对应
    • └ url
    • String
    • http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg
    • 图片链接地址
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 图片创建时间 时间格式:yyyy-MM-dd HH:mm:ss

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItemPropimgUploadTmallRequest req = new ItemPropimgUploadTmallRequest();
    req.setNumIid(123456L);
    req.setId(123456L);
    req.setProperties("1627207:28326");
    req.setPosition(122L);
    req.setImage(new FileItem("/tmp/file.txt"));
    ItemPropimgUploadTmallResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <item_propimg_upload_tmall_response>
        <prop_img>
            <id>1646146</id>
            <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
            <created>2000-01-01 00:00:00</created>
        </prop_img>
    </item_propimg_upload_tmall_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.missing-parameter:image 缺少必要的参数:image 前端做好校验,上传属性图的时候必须传入图片
    isv.item-get-service-error:ITEM_NOT_FOUND 没有找到宝贝 商品被删除或不存在,直接更新本地数据库,将旧的商品删除
    isv.item-image-upload-service-error:ITEM_NOT_FOUND 没有找到宝贝 商品被删除或不存在,直接更新本地数据库,将旧的商品删除
    isv.image-not-exist:invalid-image-id image 不存在 通过taobao.item.get获取到图片id之后再对其进行更新
    isv.item-is-delete:invalid-numIid-or-iid 该商品已被删除 通过增量接口taobao.increment.items.get获取被删除的商品,在本地数据库更新,出现此错误不要重试
    isv.picture-service-error 上传图片到图片空间报错 首先,要在前端对上传的图片进行大小校验:图片大小限3M以下, 其次,在前端对于图片类型要做好校验:只支持jpg、jpeg、gif、png、zip这几种类型的图片。 最后,在前端可以在上传前先对图片进行压缩校验图片是否真的是一张图片,防止上传攻击图片。
    isv.item-get-service-error:IC_INTERFACE_QPS_LIMIT 系统繁忙,请稍后重试 系统繁忙,请稍后重试
    isv.item-get-service-error:QUERY_USER_INFO_ERROR 系统错误,获取用户数据失败 系统错误,获取用户数据失败
    isv.item-image-upload-service-error:ICDB_QPS_LIMIT 系统繁忙,请稍后重试 系统繁忙,请稍后重试
    isv.item-image-upload-service-error:QUERY_USER_INFO_ERROR 系统错误,获取用户数据失败 系统错误,获取用户数据失败

    API工具

    如何获得此API

    FAQ

    返回
    顶部