文档中心 > API类目 > 五道口商品API

alibaba.wdk.picture.upload (图片上传接口)

上传图片

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
picture_category_id Number 必须 11 图片分类ID,设置具体某个分类ID或设置0上传到默认分类,只能传入一个分类
img byte[] 必须 图片内容 图片二进制文件流,不能为空,允许png、jpg、gif图片格式,3M以内
img_input_title String 可选 Bule.jpg 包括后缀名的图片标题,不能为空,如Bule.jpg,有些卖家希望图片上传后取图片文件的默认名
title String 可选 图片名称 图片标题,如果为空,传的图片标题就取去掉后缀名的image_input_title,超过50字符长度会截取50字符,重名会在标题末尾加"(1)";标题末尾已经有"(数字)"了,则数字加1

响应参数

名称 类型 示例值 描述
result ApiResult apiresult
  • └ success
  • Boolean
  • false
  • success
  • model
  • PictureDo
  • model
  • └ picture_id
  • Number
  • 123
  • 图片ID
  • └ picture_category_id
  • Number
  • 123
  • 图片分类ID
  • └ picture_path
  • String
  • /i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
  • 返回的是相对路劲
  • └ title
  • String
  • 图片标题
  • 图片标题
  • └ sizes
  • Number
  • 100
  • 图片大小,bite单位
  • └ status
  • String
  • unfroze
  • 图片状态,0代表没有被冻结,1代表被冻结,2代表排查通过
  • └ deleted
  • String
  • deleted
  • 图片是否删除的标记
  • └ created
  • String
  • 2000-01-01 00:00:00
  • 图片的创建时间
  • └ modified
  • String
  • 2000-01-01 00:00:00
  • 图片的修改时间
  • └ pixel
  • String
  • 450x150
  • 图片相素,格式:长x宽,如450x150
  • └ full_url
  • String
  • https://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
  • 完整的路劲
  • └ err_code
  • String
  • isv.upload-error
  • 错误code
  • └ err_msg
  • String
  • 上传图片错误
  • 错误原因

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkPictureUploadRequest req = new AlibabaWdkPictureUploadRequest();
req.setPictureCategoryId(11L);
req.setImg(new FileItem("/tmp/file.txt"));
req.setImgInputTitle("Bule.jpg");
req.setTitle("图片名称");
AlibabaWdkPictureUploadResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<alibaba_wdk_picture_upload_response>
    <result>
        <success>false</success>
        <model>
            <picture_id>123</picture_id>
            <picture_category_id>123</picture_category_id>
            <picture_path>/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg</picture_path>
            <title>图片标题</title>
            <sizes>100</sizes>
            <status>unfroze</status>
            <deleted>deleted</deleted>
            <created>2000-01-01 00:00:00</created>
            <modified>2000-01-01 00:00:00</modified>
            <pixel>450x150</pixel>
            <full_url>https://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg</full_url>
        </model>
        <err_code>isv.upload-error</err_code>
        <err_msg>上传图片错误</err_msg>
    </result>
</alibaba_wdk_picture_upload_response>

异常示例

  • XML示例
  • JSON示例
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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部