文档中心 > API类目 > 国际站商品API

alibaba.icbu.photobank.upload (图片银行图片上传开放接口)

图片银行图片上传开放接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
extra_context Json 可选 扩展参数信息,如ICVID
file_name String 必须 file.jpg 上传图片名称
group_id String 可选 17590 上传图片所在分组
image_bytes byte[] 必须 imagebytes 图片字节数组

响应参数

名称 类型 示例值 描述
upload_image_response UploadImageResponseDo 图片信息
  • └ file_name
  • String
  • HTB1c6uIXXXXXXXYXXXXq6xXFXXXH.jpg
  • 生成的图片名称
  • └ photobank_url
  • String
  • http://g03.s.alicdn.com/kf/HTB1c6uIXXXXXXXYXXXXq6xXFXXXH.jpg
  • 生成的图片全路径URL
  • └ file_id
  • Number
  • 73826382
  • 图片的唯一识别id

请求示例

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

响应示例

  • XML示例
  • JSON示例
<alibaba_icbu_photobank_upload_response>
    <upload_image_response>
        <file_name>HTB1c6uIXXXXXXXYXXXXq6xXFXXXH.jpg</file_name>
        <photobank_url>http://g03.s.alicdn.com/kf/HTB1c6uIXXXXXXXYXXXXq6xXFXXXH.jpg</photobank_url>
        <file_id>73826382</file_id>
    </upload_image_response>
</alibaba_icbu_photobank_upload_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>

错误码解释

错误码 错误描述 解决方案
SIZE_TOO_LARGE SIZE_TOO_LARGE The max limit is 5MB when uploading raw images!
FUNCTION_FORBIDDEN FUNCTION_FORBIDDEN Your account is forbidden to upload images for risk issues, please contact our developer
NOCAPACITY NOCAPACITY The capacity of your photobank is full and new images cannot be uploaded.
-2 Upload Image Error not predefined error when uploading images

API工具

如何获得此API

FAQ

返回
顶部