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

taobao.picture.upload (上传单张图片)

图片空间上传接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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:computer电脑版本宝贝使用,client:phone手机版本宝贝使用。注意:当client:phone时,图片限制为宽度在480-620之间,长度不能超过960,否则会报错。
    is_https Boolean 可选 true
  • 默认值:false
  • 是否获取https连接

    响应参数

    名称 类型 示例值 描述
    picture Picture 当前上传的一张图片信息
    • └ picture_id
    • Number
    • 123
    • 图片ID
    • └ picture_category_id
    • Number
    • 12
    • 图片分类ID
    • └ picture_path
    • String
    • http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
    • 返回的是绝对路径如:http://img07.taobaocdn.com/imgextra/i7/22670458/T2dD0kXb4cXXXXXXXX_!!22670458.jpg
    • └ title
    • String
    • title
    • 图片标题
    • └ sizes
    • Number
    • 100
    • 图片大小,bite单位
    • └ pixel
    • String
    • 450x150
    • 图片相素,格式:长x宽,如450x150
    • └ status
    • String
    • unfroze
    • 图片状态,unfroze代表没有被冻结,froze代表被冻结,pass代表排查通过
    • └ deleted
    • String
    • deleted
    • 图片是否删除的标记
    • └ client_type
    • String
    • client:computer或者client:phone
    • 图片上传的来源,有电脑版本宝贝发布,手机版本宝贝发布
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 图片的创建时间
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 图片的修改时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    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());

    响应示例

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

    异常示例

    • 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>

    错误码解释

    错误码 错误描述 解决方案
    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 图片压缩过度,禁止上传 图片压缩过度,禁止上传

    API工具

    如何获得此API

    FAQ

    返回
    顶部