型号/货号列表查询
通过类目、品牌查询标品的型号/货号列表
一、请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| uniqueCodeType | Number | 是 | 1 | 关键属性类型,3表示型号,4表示货号,人工传入 |
| categoryId | Number[] | 是 | 1233 | 类目id,来自类目接口,最多传入10个 |
| pageNo | Number | 是 | 1 | 搜索页码 |
| pageSize | Number | 是 | 10 | 搜索每页数据条数 |
| brandId | Number[] | 是 | 1122 | 品牌id,来自品牌接口,最多传入10个 |
| appName | String | 否 | 应用名称 | 应用名称 |
| ip | String | 否 | 192.168.1.1 | 如果调用方本身是一个代理(比如jos),这里应该传入真正调用来源的ip地址 |
| userAgent | String | 否 | zhangsan | 操作人/系统名称 |
二、请求示例代码
Java
请求示例代码
@Test public void JDSpuGetModelOrItemNumList() 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("categoryId", "28288"); //关键属性类型,3表示型号,4表示货号,人工传入 data.put("uniqueCodeType", "3"); data.put("pageNo", "1"); data.put("pageSize", "20"); data.put("brandId", "23423");// data.put("appId", "1784"); data.put("appName", "千里马_打单"); data.put("ip", "127.0.0.1"); data.put("userAgent", "golang"); data.put("sign", Utils.Sign(data, Config.AppSecret)); doHttpRequest(Config.JDSpuGetModelOrItemNumList, data); }三、返回结果
{ "code": 0, "message": "ok", "data": { "total": "100", "data": [{ "---": { "uniqueCode": "122345" } }], "pageNo": "1", "pageSize": "10"}}说明: code为0表示成功,非0为失败,message会包含失败原因。
四、返回字段说明
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | com.jd.gms.spu.api.response.Result | 返回结果 | |
| - success | Boolean | true | 调用是否成功 |
| - errorMessage | String | 错误信息 | 错误信息 |
| - errorCode | String | 错误码 | 错误码 |
| obj | com.jd.gms.spu.api.response.Page | 分页信息 | |
| - total | Number | 100 | 总数 |
| - data | java.util.List<com.jd.gms.spu.api.domain.ProductSpu> | 数据列表 | 数据列表 |
| — uniqueCode | String | 122345 | 关键属性值 |
| — pageNo | Number | 1 | 搜索页码 |
| — pageSize | Number | 10 | 搜索每页数据条数 |