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

taobao.picture.get (获取图片信息)

获取图片信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
picture_id Number 可选 1001 图片ID
picture_category_id Number 可选 10000 图片分类ID
deleted String 可选 1 是否删除,unfroze代表没有删除
modified_time Date 可选 2011-01-01 11:11:11 图片被修改的时间点,格式:yyyy-MM-dd HH:mm:ss。查询此修改时间点之后到目前的图片。
title String 可选 标题 图片标题,最大长度50字符,中英文都算一字符
start_date Date 可选 2000-01-01 00:00:00 查询上传开始时间点,格式:yyyy-MM-dd HH:mm:ss
end_date Date 可选 2000-01-01 00:00:00 查询上传结束时间点,格式:yyyy-MM-dd HH:mm:ss
page_no Number 可选 1
  • 默认值:1
  • 页码.传入值为1代表第一页,传入值为2代表第二页,依此类推,默认值为1
    page_size Number 可选 40
  • 默认值:40
  • 每页条数.每页返回最多返回100条,默认值40
    client_type String 可选 client:computer
  • 默认值:client:all
  • 图片使用,如果是pc宝贝detail使用,设置为client:computer,查询出来的图片是符合pc的宝贝detail显示的如果是手机宝贝detail使用,设置为client:phone,查询出来的图片是符合手机的宝贝detail显示的,默认值是全部
    order_by String 可选 time:desc
  • 默认值:time:desc
  • 图片查询结果排序,time:desc按上传时间从晚到早(默认), time:asc按上传时间从早到晚,sizes:desc按图片从大到小,sizes:asc按图片从小到大,默认time:desc
    urls String 可选 http://img.alicdn.com/i2xxxxxx.jpg,http://img01.taobacdn.com/i2xxxxxx.jpg 图片url查询接口
    is_https Boolean 可选 true
  • 默认值:false
  • 是否获取https的链接

    响应参数

    名称 类型 示例值 描述
    pictures 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
    • 图片状态,0 未审核没冻结 1 冻结 2 审核通过
    • └ 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
    • 图片的修改时间
    • └ md5
    • String
    • 1a518926c76fcf736a9afeab869dc528
    • 图片在后台处理之后的md5值当md5值为32位长度的字符串时为图片搬家后的文件md5验证码md5值为长整数时为图片替换后的时间戳
    • └ referenced
    • Boolean
    • true
    • 图片是否被引用

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    PictureGetRequest req = new PictureGetRequest();
    req.setPictureId(1001L);
    req.setPictureCategoryId(10000L);
    req.setDeleted("1");
    req.setModifiedTime(StringUtils.parseDateTime("2011-01-01 11:11:11"));
    req.setTitle("标题");
    req.setStartDate(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setPageNo(1L);
    req.setPageSize(40L);
    req.setClientType("client:computer");
    req.setOrderBy("time:desc");
    req.setUrls("http://img.alicdn.com/i2xxxxxx.jpg,http://img01.taobacdn.com/i2xxxxxx.jpg");
    req.setIsHttps(true);
    PictureGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <picture_get_response>
        <pictures>
            <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>
                <md5>1a518926c76fcf736a9afeab869dc528</md5>
                <referenced>true</referenced>
            </picture>
        </pictures>
    </picture_get_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.pictureServiceClient-service-error:PICTURE_OPERATE_FAILD 图片操作失败 检查参数并重试
    isp.top-remote-connection-timeout 连接超时 稍后再试
    isv.pictureServiceClient-service-error:null 系统错误 稍后重试
    isv.pictureServiceClient-service-error:PICTURE_PARAMETER_ERROR 参数错误 检查参数并重试
    isv.sessionkey-not-generated-by-server sessionkey无法识别 使用正确的sessionkey后重试
    isv.pictureServiceClient-service-error:SERVER_IS_BUSY 系统忙,请稍候重试 系统忙,请稍候重试
    isv.pictureServiceClient-service-error:serverException 系统出错,请稍候重试 系统出错,请稍候重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部