添加一张商品图片到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[] | 可选 | 我是被上传的文件内容 |
|
商品图片内容类型:JPG;最大:3M 。支持的文件类型:jpg,jpeg,png |
is_major | Boolean | 可选 | true |
|
是否将该图片设为主图,可选值:true,false;默认值:false(非主图) |
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); ItemImgUploadRequest req = new ItemImgUploadRequest(); req.setNumIid(1489161932L); req.setId(12345L); req.setPosition(1L); req.setImage( new FileItem( "/tmp/file.txt" )); req.setIsMajor( true ); req.setIsRectangle( false ); ItemImgUploadResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 | < item_img_upload_response > < item_img > < id >1645920</ id > < created >2000-01-01 00:00:00</ created > </ item_img > </ item_img_upload_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.missing-parameter:image | 缺少必要的参数:image | 要避免这个错误,需在前端做好校验,如果选择更改旧的图片,可以不校验图片是否存在;如果上传一张新的图片,要在前端做好必传参数校验 |
isv.image-not-exist:invalid-image-id | image 不存在 | |
isv.item-image-upload-service-error:IC_IMAGE_CHECK_IMAGE_IS_UNSUCCESSFUL | 检查图片失败 | 避免这个错误,在前端对于图片类型要做好校验:在上传前先对图片进行压缩校验图片是否真的是一张图片,防止上传攻击的图片。 |
isv.invalid-permission:image-num | 操作 image-num 权限不够、非法访问 | 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 | 参数:iid或numIid没有传入 | |
isv.user-not-exist:invalid-nick | user 不存在 | |
isv.item-image-upload-service-error:IC_ITEM_PIC_NUM_OVERFLOW | 宝贝图片数量超过限制 | |
isv.item-image-upload-service-error:IC_ITEM_PIC_IS_TOO_LARGES | 商品图片太大 | 要避免这个错误,需在前端对于图片类型要做好校验:主图不能超过500k |
isv.invalid-permission:picture-space | 操作 picture-space 权限不够、非法访问 | |
isv.item-is-delete:invalid-numIid-or-iid | 根据num_iid或iid查询到的商品一经被删除 | 这个是业务不可避免错误。可以通过一下途径来减少这个问题的发生: 使用增量api监控商品被删除的消息 发生这个错误的商品从本地数据库中删除掉,随时保持数据的同步性。 发生这个错误时不要重试。 |
isv.invalid-parameter:iid | 参数:iid无效,格式不对、非法值、越界等 | |
isv.item-get-service-error:ITEM_NOT_FOUND | 上传图片的商品找不到了 | 这个是业务不可避免错误。可以通过一下途径来减少这个问题的发生: 使用增量api监控商品被删除的消息 发生这个错误的商品从本地数据库中删除掉,随时保持数据的同步性 发生这个错误时不要重试 。 |
isv.picture-service-error | 上传图片到图片空间报错 | 避免这个错误,首先,要在前端对上传的图片进行大小校验:主图500k、非主图1m。 其次,在前端对于图片类型要做好校验:只支持jpg、jpeg、gif、png、zip这几种类型的图片。 最后,在前端可以在上传前先对图片进行压缩校验图片是否真的是一张图片,防止上传攻击的图片。 |
错误码:40,子错误码:null | 缺少必要的传入参数 | |
错误码:41,子错误码:null | 传入参数的格式错误 | |
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 | 系统错误,获取用户数据失败 | 系统错误,获取用户数据失败 |
isv.item-not-exist:invalid-numIid-or-iid | 该商品不存在 | 请检查商品是否正常 |
isv.invalid-permission:image_vertical-diagram | 竖图 长宽比不正确 | 请检查图片格式,竖图长宽比例 |
isv.invalid-permission:upload-image | 特殊类目不允许直接上传图片 | 特殊类目不允许直接上传图片 |
isv.item-image-upload-service-error:IC_ITEM_PIC_IS_TOO_LARGES-tmall | 商品的主图超过了大小 | 请求检查图片大小 |
isv.item-get-service-error:ITEM_NOT_FOUND-tmall | 商品找不到 | 请检查商品是否正确 |
isv.item-is-delete:invalid-numIid-or-iid-tmall | 该商品已被删除 | 请检查商品是否正确 |
isv.item-image-upload-service-error:IC_CANNOT_MODIFY_IMAGEPICTURL_INACTIVITY | 此商品正在参加天天特价活动,无法进行主图修改 | 此商品正在参加天天特价活动,无法进行主图修改 |
isv.invalid-parameter:image-type | 请上传属性图片 | 请上传属性图片 |
isv.invalid-permission:image-num-tmall | 商品图片不能超过数量 | 商品图片不能超过数量 |
isv.invalid-parameter:image-type-tmall | 请上传属性图片 | 请上传属性图片 |
isv.item-image-upload-service-error:IC_CANNOT_MODIFY_IMAGEPICTURL_INACTIVITY-tmall | 此商品正在参加天天特价活动,无法进行主图修改 | 此商品正在参加天天特价活动,无法进行主图修改 |
isv.error-no-permission-image | 保健品类目下,宝贝图片信息由系统生成 | 保健品类目下,宝贝图片信息由系统生成 |
isv.image-not-exist:invalid-image-id-tmall | 此图片不属于这个商品 | 请检查商品、图片和卖家的关系 |
isp.service-unavailable | 系统异常 | 请稍后重试 |
isp.top-remote-connection-timeout-tmall | 系统异常 | 请稍后重试 |
isv.item-image-upload-service-error:ITEM_NOT_FOUND-tmall | 商品找不到 | 请检查商品id是否正确 |
isv.invalid-permission:upload-image-tmall | 类目不允许直接上传图片 | 特殊类目的宝贝图片必须应用淘宝图片空间相册的图片 |
isv.item-image-upload-service-error:IC_STUFF_STATUS_SECOND_HAND_LIMITED_WITH_NOSHOP | 二手商品类目限制 | 二手商品类目限制 |
isv.picture-service-error-tmall | 系统异常 | 请稍后重试 |
isv.invalid-permission:update-item-tmall | 该商品不属于当前用户 | 请求商品与卖家的关系 |
isp.service-unavailable-tmall | 系统异常 | 请稍后重试 |
isv.item-image-upload-service-error:QUERY_USER_INFO_ERROR-tmall | 查询用户信息失败 | 查询用户信息失败 |
isv.item-image-upload-service-error:IC_ITEM_PIC_NUM_OVERFLOW-tmall | 宝贝包含图片数量超过允许发布上限 | 宝贝包含图片数量超过允许发布上限 |
isv.item-image-upload-service-error:IC_INTERFACE_QPS_LIMIT | 调用频率流控 | 请控制请求频率 |
isv.item-get-service-error:IC_INTERFACE_QPS_LIMIT-tmall | 频率限制 | 请控制请求频率 |
isv.item-image-upload-service-error | 系统错误 | 请稍后重试 |
isv.item-image-upload-service-error:IC_INTERFACE_QPS_LIMIT-tmall | 频率限制 | 请控制请求频率 |
isv.missing-parameter:numIid | 商品id错误 | 请检查商品是否正确 |
isv.invalid-parameter:image | 缺少必要的参数:image | 要避免这个错误,需在前端做好校验,如果选择更改旧的图片,可以不校验图片是否存在;如果上传一张新的图片,要在前端做好必传参数校验 |
isv.missing-parameter:image-tmall | 缺少必要的参数:image | 要避免这个错误,需在前端做好校验,如果选择更改旧的图片,可以不校验图片是否存在;如果上传一张新的图片,要在前端做好必传参数校验 |
isv.item-image-upload-service-error-tmall | 系统错误 | 请稍后重试 |
isv.item-service-error:ITEM_NOT_FOUND-tmall | 没有找到宝贝 | 请求检查商品id是否正确 |
isv.item-service-error:ITEM_NOT_FOUND | 没有找到宝贝 | 请检查商品是否正确 |
isp.item-image-upload-service-failure | 图片URL地址超过100字符 | 请修改图片URL长度后再提交 |
isv.invalid-parameter:image-tmall | 图片数据异常 | 请检查图片是否正确 |
isv.invalid-parameter:num_iid | 商品id错误 | 请检查商品是否正确 |
isp.item-get-service-unavailable-tmall | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isp.item-get-service-unavailable | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isp.item-image-upload-service-unavailable-tmall | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |