查询图片信息接口
查询图片信息接口,帮助获取图片信息
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
sign | String | 是 |
业务参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
picture_id | String | 否 | 1 | 图片ID, 来源: jingdong.imgzone.picture.query |
picture_cate_id | Number | 否 | 1 | 图片所属分类ID, 来源: jingdong.imgzone.picture.query |
picture_name | String | 否 | 1 | 图片名称,支持后模糊查询 |
start_date | Date | 否 | 1 | 创建开始时间 |
end_Date | Date | 否 | 2022-01-01 22:22:22 | 结束创建时间 |
page_num | Number | 否 | 1 | 页码值,对应分页结果页数,为空或非正整数时默认为1,超过最大页数返回空 |
page_size | Number | 否 | 1 | 每页条数,为空或非正整数时默认为20,最多返回100条 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void JDPictureQuery() throws Exception {
String sellerNick = Config.JDSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", sellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDPictureQuery, data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"total_num": "1",
"return_code": "1",
"desc": "操作成功",
"imgList": [{
"picture_cate_id": "1",
"picture_width": "1",
"picture_type": "png",
"picture_url": "1",
"referenced": "1",
"created": "2022-01-01 22:22:22",
"modified": "2022-01-01 22:22:22",
"picture_name": "1",
"picture_size": "1",
"picture_id": "1",
"picture_height": "1"
}]
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4. 返回结果说明:
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
msg | java.util.Map | 图片List集合 | |
- return_code | Number | 1 | 返回码:1,操作成功;0,操作失败 |
- desc | String | 操作成功 | 返回码为1时为操作成功,返回码为0时为操作失败原因 |
- total_num | Number | 1 | 查询的图片总数 |
imgList | java.util.List |
图片List集合 | |
- picture_id | String | 1 | 图片ID |
- picture_cate_id | Number | 1 | 图片所属分类ID |
- picture_url | String | 图片url示例 | 图片url,使用时需加上前缀:http://域名/imgzone/,具体尺寸和域名示例 |
- picture_name | String | 1 | 图片名称 |
- picture_type | String | png | 图片后缀 png |
- referenced | Number | 1 | 是否被引用:1,是;0,否 |
- picture_size | Number | 1 | 图片大小,单位b |
- picture_width | Number | 1 | 图片宽度,单位px |
- picture_height | Number | 1 | 图片高度,单位px |
- created | Date | 2022-01-01 22:22:22 | 图片创建时间 |
- modified | Date | 2022-01-01 22:22:22 | 图片修改时间 |
文档更新时间: 2024-06-28 14:37 作者:JSL