检索有效商品列表

根据条件检索商家有效商品信息,适用于管理端按标题、类目、状态、货号等条件分页查询商品列表。


一、接口名称

项目 说明
接口名称 检索有效商品列表
接口地址 https://kf.fw199.com/gateway/jd/ware/searchWare4Valid
请求方式 POST
Content-Type application/x-www-form-urlencoded

二、请求参数

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 是 合作伙伴 AppId
timestamp String 是 1657525936 当前 Unix 时间戳,秒
seller_nick String 是 38173182 京东账号,对应蜂巢授权返回的 jdseller 字段
sign String 是 参数签名,算法见 蜂巢开放平台开发指南
sysid String 否 404 应用标识。

业务参数

名称 类型 必须 示例值 描述
listProductsRequest json 否 查询字段

三、请求示例代码(Java)

@Test
public void JDSearchWare4Valid() 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("listProductsRequest",
                "{\"page\":1,\"pageSize\":20,"
                        + "\"scopeSet\":[\"wareId\",\"title\",\"wareStatus\",\"categoryId\",\"jdPrice\",\"stockNum\"]}");


    data.put("sign", Utils.Sign(data, Config.AppSecret));
    String result = doHttpRequest(Config.baseUrl + "/gateway/jd/ware/searchWare4Valid", data);
    System.out.println("result:" + result);
}

四、返回结果

说明:最外层 code 为 0 表示成功,非 0 为失败,message 会包含失败原因。data 内业务字段见 京东官方文档。

商品主图相对路径需自行拼接京东图片前缀,例如:https://img12.360buyimg.com/n5/。

4.1 成功示例

{"code":0,"message":"ok","data":{"data":[{"brandDTO":{},"categoryDTO":{"lastCategoryId":6911,"thirdCategoryId":6911},"gaeaFlag":false,"logisticsDTO":{},"priceDTO":{"jdPrice":2},"productFrontDetailDTO":{},"productId":10035324192622,"stockNum":8}],"paginationData":{"currentPage":1,"pageSize":20,"totalItems":1},"success":true},"trace_id":"06464849-76f1-4e61-a20c-e2c6a3e758f6"}
文档更新时间: 2026-09-15 18:25   作者:admin