* 关联一张商品图片到num_iid指定的商品中 * 传入的num_iid所对应的商品必须属于当前会话的用户 * 商品图片关联在卖家身份和图片来源上的限制，卖家要是B卖家或订购了多图服务才能关联图片，并且图片要来自于卖家自己的图片空间才行 * 商品图片数量有限制。不管是上传的图片还是关联的图片，他们的总数不能超过一定限额
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| num_iid | Number | 必须 | 1233 | 商品数字ID，必选 | |
| id | Number | 可选 | 212195 |
|
商品图片id(如果是更新图片，则需要传该参数) |
| position | Number | 可选 | 1 |
|
图片序号 |
| pic_path | String | 必须 | i5/65753805/T2rFXXXbu2XXXXXXXX_!!65753805.jpg | 图片URL,图片空间图片的相对地址，支持的文件类型：jpg,jpeg,png | |
| is_major | Boolean | 可选 | true |
|
上传的图片是否关联为商品主图 |
| is_rectangle | Boolean | 可选 | false |
|
是否3:4长方形图片，绑定3:4主图视频时用于上传3:4商品主图 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| item_img | ItemImg | 商品图片信息 | |
|
|||
1 2 3 4 5 6 7 8 9 10 | 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()); |
1 2 3 4 5 6 7 | <item_joint_img_response> <item_img> <id>1645920</id> <created>2000-01-01 00:00:00</created> </item_img></item_joint_img_response> |
1 2 3 4 5 6 | <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 | 应用异常，请稍候重试 | 应用异常，请稍候重试 |
