图片空间-获取图片信息

获取图片信息

获取图片信息

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/picture/get

基本参数

参数名	类型	说明	示例
appid	String	合作伙伴AppId	uwkahf@jfs92
timestamp	String	当前时间戳
tb_seller_nick	String	淘宝卖家店铺登录账号，非店铺名称	kingdo
sign	String	接口签名	如何计算生成见示例代码
sysid	String	可空，代表不同的应用，具体请咨询客服

业务参数

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

二、请求示例代码

Java

@Test
    public void  TaoBaoPictureGet() throws Exception {
       String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("page_no", "1");
        data.put("page_size", "20");
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoPictureGet ,data);

    }

三、返回结果

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "picture_id": 1317608148124034300,
      "picture_category_id": 1317616207439452700,
      "picture_path": "https://img.alicdn.com/imgextra/i1/661153176/O1CN01wAjhpK1ZKesKzFtcy_!!661153176.jpg",
      "title": "1720753124223.jpg",
      "sizes": 3914,
      "pixel": "1500x99",
      "status": "0",
      "deleted": "0",
      "client_type": "client:computer",
      "created": "2024-07-12 10:58:44",
      "modified": "2024-07-12 10:58:44",
      "md5": "b66b8d5fe81d5f93550515766ccb599b",
      "referenced": true
    },
    {
      "picture_id": 1317608112423109600,
      "picture_category_id": 1317618088238816500,
      "picture_path": "https://img.alicdn.com/imgextra/i2/661153176/O1CN01nKCTpF1ZKeri1ASF4_!!661153176.jpg",
      "title": "734040495257PC19460314668728320.jpg",
      "sizes": 205878,
      "pixel": "790x910",
      "status": "0",
      "deleted": "0",
      "client_type": "client:computer",
      "created": "2024-05-29 19:33:56",
      "modified": "2024-05-29 19:33:56",
      "md5": "d17940c3ce3afb6eb6ac43f90afe7c3c",
      "referenced": false
    }
  ],
  "trace_id": ""
}

说明： code为0表示成功，如果失败，msg会包含失败原因。　返回的字段说明

名称	类型	示例值	描述
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	图片是否被引用