查询图片信息接口

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

一、请求参数

请求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条

二、请求示例代码

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);
    }

三、返回结果

{
    "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会包含失败原因。

四、返回结果说明

名称	类型	示例值	描述
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	图片修改时间