图片空间上传接口
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
picture_category_id | Number | 必须 | 123 | 图片分类ID,设置具体某个分类ID或设置0上传到默认分类,只能传入一个分类 | |
img | byte[] | 必须 | 我是被上传的文件内容 | 图片二进制文件流,不能为空,允许png、jpg、gif图片格式,3M以内。 | |
image_input_title | String | 必须 | Bule.jpg | 包括后缀名的图片标题,不能为空,如Bule.jpg,有些卖家希望图片上传后取图片文件的默认名 | |
title | String | 可选 | 图片名称 | 图片标题,如果为空,传的图片标题就取去掉后缀名的image_input_title,超过50字符长度会截取50字符,重名会在标题末尾加"(1)";标题末尾已经有"(数字)"了,则数字加1 | |
client_type | String | 可选 | client:computer |
|
图片上传的来源,有电脑版本宝贝发布,手机版本宝贝发布client:computer电脑版本宝贝使用,client:phone手机版本宝贝使用。注意:当client:phone时,图片限制为宽度在480-620之间,长度不能超过960,否则会报错。 |
is_https | Boolean | 可选 | true |
|
是否获取https连接 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
picture | Picture | 当前上传的一张图片信息 | |
|
1 2 3 4 5 6 7 8 9 10 11 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); PictureUploadRequest req = new PictureUploadRequest(); req.setPictureId(10000L); req.setPictureCategoryId(123L); req.setImg( new FileItem( "/tmp/file.txt" )); req.setImageInputTitle( "Bule.jpg" ); req.setTitle( "图片名称" ); req.setClientType( "client:computer" ); req.setIsHttps( true ); PictureUploadResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | < picture_upload_response > < picture > < picture_id >123</ picture_id > < picture_category_id >12</ picture_category_id > < picture_path >http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg</ picture_path > < title >title</ title > < sizes >100</ sizes > < pixel >450x150</ pixel > < status >unfroze</ status > < deleted >deleted</ deleted > < client_type >client:computer或者client:phone</ client_type > < created >2000-01-01 00:00:00</ created > < modified >2000-01-01 00:00:00</ modified > </ picture > </ picture_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 > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
service is busy. | 服务端限流 | 请降低上传速率 |
isv.pictureServiceClient-service-error:PICTURE_OVER_AVAILSPACE | 容量超出限制 | 购买功能包或清理空间 |
isv.pictureServiceClient-service-error:FORBID_CONSUMER_UPLOAD | 消费者禁用图片空间 | 消费者身份禁用图片空间 |
isv.pictureServiceClient-service-error:PICTURE_UPLOAD_FORMAT_ERROR | 图片宽度需要大于480像素 | 图片宽度需要大于480像素 |
isv.pictureServiceClient-service-error:CATEGORY_NOTEXIST | 图片空间目录信息不存在 | 请检查目录ID是否正确,修改后再提交 |
isv.pictureServiceClient-service-error:PICTURE_ERROR_FORMAT | 图片格式不正确 | 图片必须为png、jpg、gif格式,大小5M以内。 |
isv.pictureServiceClient-service-error:PICTURE_OVER_MAXSIZE | 图片超过最大长度限制 | 上传图片必须限制在3M以内 |
isv.pictureServiceClient-service-error:serverException | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isv.pictureServiceClient-service-error:PICTURE_ERROR_MODE_CMYK | 不允许上传CMYK模式的图片 | 不允许上传CMYK模式的图片 |
isv.pictureServiceClient-service-error:PICTURE_SYS_ERROR | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isv.pictureServiceClient-service-error:PICTURE_NAME_INVALID | 图片名称格式不正确 | 传的图片标题就取去掉后缀名的image_input_title,超过50字符长度会截取50字符,重名会在标题末尾加"(1)" |
isv.pictureServiceClient-service-error:TOO_MANY_REQUESTS | 图片上传请求频率太快 | 请控制上传速率,同一商家下避免并发上传 |
isp.pictureServiceClient-service-error:PICTURE_SYS_ERROR | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isp.pictureServiceClient-service-error:SERVER_IS_BUSY | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isp.call-limited | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isv.pictureServiceClient-service-error:SAVE_TO_TFS_EXCEPTION | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isv.pictureServiceClient-service-error:null | 系统繁忙,请稍后重试 | 系统繁忙,请稍后重试 |
isp.picture-service-unavailable | 服务暂时不可用 | 重试 |
isv.pictureServiceClient-service-error:IMAGE_PIXEL_NOT_VALID | 图片像素值不在允许范围内,宽度0-10000,高度0-10000 | 图片像素值不在允许范围内,宽度0-10000,高度0-10000 |
isv.pictureServiceClient-service-error:ERROR_IMAGE_QUALITY_NOT_GOOD_ENOUGH | 图片压缩过度,禁止上传 | 图片压缩过度,禁止上传 |