检索有效商品列表
根据条件检索商家有效商品信息,适用于管理端按标题、类目、状态、货号等条件分页查询商品列表。
一、接口名称
| 项目 | 说明 |
|---|---|
| 接口名称 | 检索有效商品列表 |
| 接口地址 | 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