获取图片信息

获取图片信息

1.请求参数

请求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的链接

2. 请求示例代码(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);

    }

3. 返回结果如下:

{
  "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 图片是否被引用
文档更新时间: 2025-01-09 20:00   作者:admin