文档中心 > API类目 > 全球速卖通-商品管理

aliexpress.photobank.redefining.uploadimageforsdk (上传图片到图片银行(推荐使用))

将商品图片上传到图片银行。这个接口与api.uploadImage的区别在于显式提供imageBytes参数用于设置图片的二进制数据。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
group_id String 可选 0 图片保存的图片组,groupId为空,则图片保存在Other组中。
image_bytes byte[] 可选 0 图片文件的字节流图片大小限制:3MB。图片大小不能超过5000*5000。
支持的文件类型:
file_name String 可选 0 上传文件名称,长度不要超过256个字符。

响应参数

名称 类型 示例值 描述
result AeopUploadImageResponse 0 result
  • └ error_message
  • String
  • 系统异常!
  • 错误信息
  • └ file_name
  • String
  • test2.png
  • 图片的名称。
  • └ height
  • Number
  • 1210
  • 图片的高度。单位:像素
  • └ photobank_total_size
  • String
  • 6144.00
  • 图片银行总的空间大小。单位:MB
  • └ photobank_url
  • String
  • http://g02.a.alicdn.com/kf/HT
  • 这张图片的URL。
  • └ photobank_used_size
  • String
  • 96.95
  • 已经使用了的图片银行空间。单位:MB
  • └ status
  • Json
  • SUCCESS
  • 图片上传的结果。
  • └ width
  • Number
  • 858
  • 图片的宽度。单位:像素
  • └ is_success
  • Boolean
  • true
  • isSuccess
  • └ error_code
  • Number
  • 16009999
  • 错误代码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressPhotobankRedefiningUploadimageforsdkRequest req = new AliexpressPhotobankRedefiningUploadimageforsdkRequest();
req.setGroupId("0");
req.setImageBytes(new FileItem("/tmp/file.txt"));
req.setFileName("0");
AliexpressPhotobankRedefiningUploadimageforsdkResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_photobank_redefining_uploadimageforsdk_response>
    <result>
        <error_message>系统异常!</error_message>
        <file_name>test2.png</file_name>
        <height>1210</height>
        <photobank_total_size>6144.00</photobank_total_size>
        <photobank_url>http://g02.a.alicdn.com/kf/HT</photobank_url>
        <photobank_used_size>96.95</photobank_used_size>
        <status>SUCCESS</status>
        <width>858</width>
        <is_success>true</is_success>
        <error_code>16009999</error_code>
    </result>
</aliexpress_photobank_redefining_uploadimageforsdk_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>

错误码解释

错误码 错误描述 解决方案
1202016 Photobank:null 检查图片 图片色彩空间为RGB、不能上传CRMK 图片颜色描述文件不能为:Japan Color 2001 Coated
1202013 Photobank:null 图片银行空间已满,请商家清理部分无用的图片,或申请扩容。

API工具

如何获得此API

FAQ

返回
顶部