获取图片信息
获取图片信息
1.请求参数
请求URL:
基本参数
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
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