文档中心 > API类目 > 商品编辑

taobao.item.joint.img (商品关联子图)

* 关联一张商品图片到num_iid指定的商品中 * 传入的num_iid所对应的商品必须属于当前会话的用户 * 商品图片关联在卖家身份和图片来源上的限制,卖家要是B卖家或订购了多图服务才能关联图片,并且图片要来自于卖家自己的图片空间才行 * 商品图片数量有限制。不管是上传的图片还是关联的图片,他们的总数不能超过一定限额

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
num_iid Number 必须 1233 商品数字ID,必选
id Number 可选 212195
  • 默认值:0
  • 商品图片id(如果是更新图片,则需要传该参数)
    position Number 可选 1
  • 默认值:0
  • 图片序号
    pic_path String 必须 i5/65753805/T2rFXXXbu2XXXXXXXX_!!65753805.jpg 图片URL,图片空间图片的相对地址,支持的文件类型:jpg,jpeg,png
    is_major Boolean 可选 true
  • 默认值: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);
    ItemJointImgRequest req = new ItemJointImgRequest();
    req.setNumIid(1233L);
    req.setId(212195L);
    req.setPosition(1L);
    req.setPicPath("i5/65753805/T2rFXXXbu2XXXXXXXX_!!65753805.jpg");
    req.setIsMajor(true);
    req.setIsRectangle(false);
    ItemJointImgResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <item_joint_img_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_joint_img_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.user-not-exist:invalid-nick user 不存在
    isv.invalid-permission:image-num 操作 image-num 权限不够、非法访问 Taobao.user.get返回字段里面item_img_num对于此限定范围有返回,isv在上传之前需要将已经有的商品图片数和可上传的数量进行校验,如果已经满额就不要再新增图片。
    isv.invalid-parameter:picPath 参数:picPath无效,格式不对、非法值、越界等 在调用api关联图片前,先按照说明的规则对图片地址进行校验,不符合规则的图片就不让关联。 关联的图片最好是让用户从图片空间的图片中选择,而不是让用户自己输入图片地址。
    isv.invalid-permission:picture-space 操作 picture-space 权限不够、非法访问
    isv.item-image-upload-service-error:ITEM_NOT_FOUND 没有找到宝贝 这个是业务不可避免错误。可以通过一下途径来减少这个问题的发生: 使用增量api监控商品被删除的消息, 发生这个错误的商品从本地数据库中删除掉,随时保持数据的同步性。 发生这个错误时不要重试。
    isv.item-is-delete:invalid-numIid-or-iid numiid或iid已经删除 这个是业务不可避免错误。可以通过一下途径来减少这个问题的发生: 使用增量api监控商品被删除的消息, 发生这个错误的商品从本地数据库中删除掉,随时保持数据的同步性。 发生这个错误时不要重试。
    错误码:40,子错误码:null 缺少必要的传入参数
    isv.invalid-permission:upload-picPath-unconfirmed 操作 upload-picPath-unconfirmed 权限不够、非法访问 成人类目不允许上传未被审核通过的图片
    isv.item-image-upload-service-error:IC_ITEM_PIC_NUM_OVERFLOW 宝贝图片数量超过限制 宝贝图片数量超过限制
    isv.item-get-service-error:ITEM_NOT_FOUND 没有找到宝贝 没有找到宝贝
    isv.item-get-service-error:IC_INTERFACE_QPS_LIMIT 系统繁忙,请稍后重试 系统繁忙,请稍后重试
    isv.item-get-service-error:QUERY_USER_INFO_ERROR 系统错误,获取用户数据失败 系统错误,获取用户数据失败
    isv.item-image-upload-service-error:IC_INTERFACE_QPS_LIMIT 系统繁忙,请稍后重试 系统繁忙,请稍后重试
    isv.item-image-upload-service-error:QUERY_USER_INFO_ERROR 系统错误,获取用户数据失败 系统错误,获取用户数据失败
    isv.invalid-permission:image_vertical-diagram 宝贝长图不符合要求,长图必须符合宽(橫):高(竖)=2:3,且最小宽度为480px 请修改长图尺寸后再提交
    isv.invalid-permission:image-num-tmall 商品图片数量超过限制 商品图片数量超过限制
    isv.item-is-delete:invalid-numIid-or-iid-tmall 商品不存在或已删除 商品不存在或已删除,请检查numIid参数
    isv.invalid-parameter:picPath-tmall 参数picPath格式不正确 请检查参数picPath格式,修改后提交
    isv.invalid-permission:update-item-tmall 商品更新权限错误,该商品不属于当前授权用户 请检查当前授权用户与商品间的关系
    isp.top-remote-connection-timeout-tmall 应用异常,请稍候重试 应用异常,请稍候重试
    isv.item-image-upload-service-error:IC_CANNOT_MODIFY_IMAGEPICTURL_INACTIVITY 此商品正在参加天天特价活动,无法进行主图修改 此商品正在参加天天特价活动,无法进行主图修改
    isv.item-image-upload-service-error:ICDB_QPS_LIMIT 应用异常,请稍候重试 应用异常,请稍候重试
    isv.invalid-permission:update-item 商品更新权限错误,该商品不属于当前授权用户 请检查当前授权用户与商品间的关系
    isv.invalid-parameter:image 参数image格式不正确 请检查image参数,修改后再提交
    isv.item-image-upload-service-error:IC_STUFF_STATUS_NEW_LIMITED_WITH_NOPREPAY 发布、编辑上架和上架全新宝贝需冻结消费者保障服务保证金 发布、编辑上架和上架全新宝贝需冻结消费者保障服务保证金
    isv.item-service-error:ITEM_NOT_FOUND-tmall 商品不存在或已删除 商品不存在或已删除,请不要重试
    isv.invalid-parameter:image-tmall 参数image格式不正确 请检查image参数,修改后再提交
    isv.item-image-upload-service-error 保存商品图片失败,商品图片大小不能超过3M 保存商品图片失败,商品图片大小不能超过3M
    isv.item-image-upload-service-error-tmall 保存商品图片失败,商品图片大小不能超过3M 保存商品图片失败,商品图片大小不能超过3M
    isv.invalid-parameter:image-type-tmall 图片格式检查不正确,支持的文件类型:jpg,jpeg,png 图片格式检查不正确,支持的文件类型:jpg,jpeg,png
    isp.service-unavailable-tmall 应用异常,请稍候重试 应用异常,请稍候重试
    isp.item-image-upload-service-failure 系统繁忙,请稍后重试 系统繁忙,请稍后重试
    isv.item-service-error:ITEM_NOT_FOUND 商品不存在或已删除 商品不存在或已删除,请不要重试
    isv.antisteal-service-failed-tmall 主图盗图盗链校验未通过,请重新选择图片 主图盗图盗链校验未通过,请重新选择图片
    isv.invalid-parameter:image-type 图片格式检查不正确,支持的文件类型:jpg,jpeg,png 图片格式检查不正确,支持的文件类型:jpg,jpeg,png
    isv.invalid-permission:tjb-not-allowed 淘宝特价版商品不支持操作 淘宝特价版商品不支持操作
    isp.item-service-error 应用异常,请稍后重试 应用异常,请稍后重试
    isv.invalid-parameter:num_iid 参数num_iid格式不正确 参数num_iid格式不正确,请填写正确的商品ID
    isp.item-get-service-unavailable 应用异常,请稍候重试 应用异常,请稍候重试
    isp.item-image-upload-service-unavailable-tmall 应用异常,请稍候重试 应用异常,请稍候重试
    isp.item-get-service-unavailable-tmall 应用异常,请稍候重试 应用异常,请稍候重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部