文档中心 > API类目 > 多媒体平台API

alibaba.tjb.picture.upload (淘特图片空间上传单张图片)

淘特图片空间上传单张图片

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
file_name String 必须 测试图片.jpg 图片名,可包含扩展名,与上传后返回的图片名一致。最长50个字符,不允许/,\,:,*,?,",<,>,|,;这些特殊字符。
file_data byte[] 必须 [111,222,333] 图片的二进制流。允许png、jpg、gif图片格式,3M以内。
folder_id Number 必须 0 指定传入的文件夹id,根文件夹为0

响应参数

名称 类型 示例值 描述
picture TopPictureDTO 图片信息
  • └ file_id
  • Number
  • 123
  • 图片文件id
  • └ file_name
  • String
  • "测试图片"
  • 图片名
  • └ folder_id
  • Number
  • 0
  • 所属文件夹id
  • └ biz_status
  • String
  • "NORMAL"
  • 审核状态。"AUDITING":审核中, FROZEN:被冻结 ,"NORMAL":正常"
  • └ deleted_status
  • String
  • "NORMAL"
  • "NORMAL":正常,"RECYCLED":回收站中
  • └ full_url
  • String
  • "https://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg"
  • 图片完整链接,直接通过这个链接可以访问图片
  • └ pixel
  • String
  • "100x200"
  • 分辨率,格式:长x宽,如450x150
  • └ size
  • Number
  • 1024
  • 图片的大小,单位为字节
  • └ extension_name
  • String
  • jpg
  • 图片扩展名
  • └ compress_picture_url
  • String
  • "https://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg_100x100"
  • 缩略图地址

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTjbPictureUploadRequest req = new AlibabaTjbPictureUploadRequest();
req.setFileName("测试图片.jpg");
req.setFileData(new FileItem("/tmp/file.txt"));
req.setFolderId(0L);
AlibabaTjbPictureUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_tjb_picture_upload_response>
    <picture>
        <file_id>123</file_id>
        <file_name>&quot;测试图片&quot;</file_name>
        <folder_id>0</folder_id>
        <biz_status>&quot;NORMAL&quot;</biz_status>
        <deleted_status>&quot;NORMAL&quot;</deleted_status>
        <full_url>&quot;https://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg&quot;</full_url>
        <pixel>&quot;100x200&quot;</pixel>
        <size>1024</size>
        <extension_name>jpg</extension_name>
        <compress_picture_url>&quot;https://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg_100x100&quot;</compress_picture_url>
    </picture>
</alibaba_tjb_picture_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>

错误码解释

错误码 错误描述 解决方案
isv.uploadPicture-service-error:6405 用户容量达到上限 用户容量目前根据商家等级自动分配,提升等级可提升容量上限,具体可到商家端图片空间后台查看。
isv.invalid-parameter 参数校验错误。如:文件名称中含有非法字符,图片超过了3MB,图片名超过了50个字符。 保证参数的格式的正确
isv.uploadPicture-service-error:6029 文件类型无法确定。 可以用ps重新导出图片再上传。
isv.uploadPicture-service-error:6406 当前用户非淘特卖家 用户需要注册成为淘特卖家
isv.uploadPicture-service-error:6006 目标文件夹不存在 保证folder_id的正确性,确认是当前用户的folder_id
isp.remote-service-error 服务端处理异常 可能是服务不稳定,可稍后再试或联系服务提供方

API工具

如何获得此API

FAQ

返回
顶部