检索有效商品列表

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

一、接口名称

二、请求参数

公共参数

业务参数

wareStatusValue 商品状态

查询在售商品时传 wareStatusValue=8。

field 可选返回字段

常用值（与 获取单个商品 的 Ware 对象一致）：

wareId,title,categoryId,brandId,templateId,transportId,wareStatus,outerId,itemNum,barCode,wareLocation,created,modified,offlineTime,onlineTime,colType,delivery,adWords,wrap,packListing,weight,width,height,length,props,features,images,shopCategorys,mobileDesc,introduction,afterSales,logo,marketPrice,costPrice,jdPrice,brandName,stockNum,categorySecId,shopId,promiseId,multiCategoryId,multiCateProps,sellPoint,parentId,spuId

嵌套字段示例：adWords.words、adWords.url、images.colorId、images.imgId、images.imgUrl、images.imgIndex、images.isMain、shopCategorys.shopCategoryLevel1、shopCategorys.shopCategoryLevel2。

完整字段说明以京东官方文档为准。

三、请求示例代码（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("pageNo", "1");
    data.put("pageSize", "20");
    data.put("wareStatusValue", "8");
    data.put("orderFiled", "modified");
    data.put("orderType", "desc");
    String fields = "wareId,title,categoryId,brandId,templateId,transportId,wareStatus,outerId,itemNum,barCode,wareLocation,modified,created,offlineTime,onlineTime,colType,logo,marketPrice,costPrice,jdPrice,brandName,stockNum,shopId,promiseId";
    data.put("field", fields);

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

按标题模糊检索示例：再增加 searchKey、searchField：

data.put("searchKey", "测试商品");
data.put("searchField", "title");

四、返回结果

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

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

4.1 成功示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "code": "0",
    "page": {
      "data": [
        {
          "wareId": 10026288980564,
          "title": "测试品牌1夏季女士T恤衫0802-1",
          "categoryId": 1355,
          "brandId": 955844,
          "brandName": "测试品牌（0506-2）",
          "wareStatus": 8,
          "outerId": "454",
          "itemNum": "sjbm0802",
          "logo": "jfs/t1/298416/5/3366/55514/681888e8F6c0619c3/5c63b1c6e2393d3b.jpg",
          "jdPrice": 150,
          "marketPrice": 181,
          "stockNum": 0,
          "shopId": 617857,
          "created": 1722566191000,
          "modified": 1749156585000,
          "onlineTime": 1733890832000,
          "offlineTime": 1733311601000
        }
      ],
      "pageNo": 1,
      "pageSize": 20,
      "totalItem": 1
    }
  }
}

data.page 字段说明

Ware 常见字段