查询图片信息接口

查询图片信息接口,帮助获取图片信息

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/imgzone/picture/query

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
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