taobao.item.img.upload.tmall (添加商品图片)

添加一张商品图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用户 如果更新图片需要设置itemimg_id,且该itemimg_id的图片记录需要属于传入的num_iid对应的商品。如果新增图片则不用设置 。 使用taobao.item.seller.get中返回的item_imgs字段获取图片id。 商品图片有数量和大小上的限制,根据卖家享有的服务(如:卖家订购了多图服务等),商品图片数量限制不同。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
num_iid Number 必须 1489161932 商品数字ID,该参数必须
id Number 可选 12345 商品图片id(如果是更新图片,则需要传该参数)
position Number 可选 1 图片序号
image byte[] 可选 我是被上传的文件内容
  • 最大长度:3145728
  • 商品图片内容类型:JPG,GIF;最大:3M 。支持的文件类型:gif,jpg,jpeg,png
    is_major Boolean 可选 true
  • 默认值:false
  • 是否将该图片设为主图,可选值:true,false;默认值:false(非主图)
    is_rectangle Boolean 可选 false
  • 默认值:false
  • 是否3:4长方形图片,绑定3:4主图视频时用于上传3:4商品主图

    响应参数

    名称 类型 示例值 描述
    item_img ItemImg 商品图片结构
    • └ id
    • Number
    • 1645920
    • 商品图片的id,和商品相对应(主图id默认为0)
    • └ 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);
    ItemImgUploadTmallRequest req = new ItemImgUploadTmallRequest();
    req.setNumIid(1489161932L);
    req.setId(12345L);
    req.setPosition(1L);
    req.setImage(new FileItem("/tmp/file.txt"));
    req.setIsMajor(true);
    req.setIsRectangle(false);
    ItemImgUploadTmallResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <item_img_upload_tmall_response>
        <item_img>
            <id>1645920</id>
            <url>http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg</url>
            <created>2000-01-01 00:00:00</created>
        </item_img>
    </item_img_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.image-not-exist:invalid-image-id image 不存在 通过taobao.item.get获取到图片id之后再对其进行更新
    isv.item-image-upload-service-error:IC_IMAGE_CHECK_IMAGE_IS_UNSUCCESSFUL 检查图片失败 避免这个错误,在前端对于图片类型要做好校验:在上传前先对图片进行压缩校验图片是否真的是一张图片,防止上传攻击的图片。
    isv.invalid-permission:image-num 商品图片不能超过5张 Taobao.user.get返回字段里的item_img_num对于此限定范围有返回,在上传之前需要将已经有的商品图片数和可上传的数量进行校验,如果已经满额就不要再新增图片。
    isv.item-image-upload-service-error:IC_IMAGE_TYPE_IS_UNSUPPORTED 不支持该图片类型 避免这个错误,在前端对于图片类型要做好校验:只支持jpg、jpeg、gif、png、zip这几种类型的图片。
    isv.invalid-permission:update-item 操作 update-item 权限不够、非法访问 要避免这个错误,需在上传图片之前要先对商品的类目(cid)进行判断,如果是成人类目的商品就不要调用这个接口上传图片了。
    isv.missing-parameter:iid-or-numIid 参数:num_iid没有传入 前端做好判断,必须传入num_iid
    isv.user-not-exist:invalid-nick user 不存在 从本地数据库将此用户清除
    isv.item-image-upload-service-error:IC_ITEM_PIC_IS_TOO_LARGES 商品图片太大 要避免这个错误,需在前端对于图片类型要做好校验:主图不能超过3M
    isv.invalid-permission:picture-space 操作 picture-space 权限不够、非法访问 非多图用户(B卖家或实名认证或买了多图服务)不能上传商品多图
    isv.item-is-delete:invalid-numIid-or-iid 根据num_iid或iid查询到的商品一经被删除 这个是业务不可避免错误。可以通过一下途径来减少这个问题的发生: 使用增量api监控商品被删除的消息 发生这个错误的商品从本地数据库中删除掉,随时保持数据的同步性。 发生这个错误时不要重试。
    isv.item-get-service-error:ITEM_NOT_FOUND 没有找到宝贝 1. 确认num_iid是否正确,可通过taobao.items.onsale.get和taobao.items.inventory.get 获取正确的宝贝num_iid,再通过taobao.item.get接口查询宝贝详情; 2. 如果num_iid无误,则对应的宝贝可能已违规或进入历史库,在本地增加逻辑:发现报商品不存在的错误(ITEM_NOT_FOUND)就将本地的商品记录删除掉,防止卖家或者系统自动重试再次发生这个问题。发生这个错误时不要重试。
    isv.picture-service-error 上传图片到图片空间报错 首先,要在前端对上传的图片进行大小校验:图片大小限3M以下。 其次,在前端对于图片类型要做好校验:只支持jpg、jpeg、gif、png、zip这几种类型的图片。 最后,在前端可以在上传前先对图片进行压缩校验图片是否真的是一张图片,防止上传攻击图片。
    isv.item-image-upload-service-error:IC_ITEM_PIC_NUM_OVERFLOW 宝贝图片数量超过限制 宝贝图片数量超过限制
    isv.item-image-upload-service-error:IC_STUFF_STATUS_NEW_LIMITED_WITH_NOPREPAY 该类目下发布、编辑和上架全新宝贝需要冻结消费者保障服务保证金 该类目下发布、编辑和上架全新宝贝需要冻结消费者保障服务保证金
    isv.item-image-upload-service-error:IC_STUFF_STATUS_NEW_LIMITED_WITH_NOSHOP 发布、编辑和上架全新宝贝必须是店铺卖家 发布、编辑和上架全新宝贝必须是店铺卖家
    isv.item-image-upload-service-error:ERROR_ALCOHOL_PERMISSION_INVALID 没有发布酒类宝贝的权限 没有发布酒类宝贝的权限
    isv.item-image-upload-service-error:ITEM_NOT_FOUND 没有找到宝贝 没有找到宝贝
    isv.item-image-upload-service-error:ICDB_QPS_LIMIT 系统繁忙,请稍后重试 系统繁忙,请稍后重试
    isv.item-image-upload-service-error:QUERY_USER_INFO_ERROR 系统错误,获取用户数据失败 系统错误,获取用户数据失败

    API工具

    如何获得此API

    FAQ

    返回
    顶部