1688分销增强商品列表接口
获取1688分销商品,可以类目、关键词、是否支持一件代发等多维度查询商品。
1.请求参数:
请求URL:
基础参数
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | 32432143214214 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
seller_nick | String | true | b2b-1624961122 | 1688账号 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
业务参数
名称 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
pageNum | Integer | 否 | 当前页码 | 1 |
pageSize | Integer | 否 | 分页大小(默认为20) | 10 |
keyword | String | 否 | 关键词 | “连衣裙” |
categoryId | Long | 否 | 类目Id,1,2,3级均可,填几级类目就限定到第几级 | 80 |
priceStart | String | 否 | 价格区间开始(大市场价格,元) | “1” |
priceEnd | String | 否 | 价格区间结束(大市场价格,元) | “10” |
filters | String | 否 | 过滤条件,多个可以使用英文逗号隔开,如下: isOnePsale:一件代发 isOnePsaleFreePost:一件代发包邮 noReason7DReturn:7天无理由退货 |
”isOnePsale” |
2. 请求示例代码(Java)
@Test
public void AlibabaFenxiaoJXHYRequest() throws Exception {
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", Config.AlibabaFenXiaoSellerNick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("filters", "isOnePsale");
data.put("categoryId", "10166");
data.put("keyword", "衬衫");
data.put("pageNum", "1");
data.put("pageSize", "20");
data.put("sign", Utils.Sign(data, Config.AppSecret));
// 调用服务API
String response = doHttpRequest(Config.AlibabaFenxiaoJXHYRequestUrl, data);
}
3. 返回结果如下:
3.1成功情况
{
"code": 0,
"message": "ok",
"data": {
"success": true,
"code": "0",
"result": [
{
"imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01PcPUqt2Lyaja6dt7l_!!2213051949761-0-cib.jpg",
"itemId": 667701506689,
"maxPrice": 1850,
"minPrice": 1850,
"salesCnt90d": 215,
"serviceList": [
{
"code": "ssbxsfh",
"name": "48小时发货"
},
{
"code": "qtbh",
"name": "7天包换"
},
{
"code": "qtwlybt",
"name": "7天无理由包退"
},
{
"code": "czbz",
"name": "材质保障(限地区)"
}
],
"title": "春季韩版修身白衬衫女长袖学生职业装工装小清新打底衬衣女工作服",
"skuCnt": 126
},
{
"imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01tqv0BY2CtFckiUxG6_!!4092448531-0-cib.jpg",
"itemId": 690717559861,
"maxPrice": 6000,
"minPrice": 6000,
"salesCnt90d": 39,
"serviceList": [
{
"code": "ssbxsfh",
"name": "48小时发货"
},
{
"code": "qtbh",
"name": "7天包换"
},
{
"code": "czbz",
"name": "材质保障(限地区)"
}
],
"title": "软糯韩系温柔纯色棉衬衫女2024春秋新款叠穿内搭宽松休闲上衣外套",
"skuCnt": 4
},
{
"imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01bhb32M2EGRY0kHuOH_!!2212169528717-0-cib.jpg",
"itemId": 863317895852,
"maxPrice": 3300,
"minPrice": 3300,
"serviceList": [
{
"code": "ssbxsfh",
"name": "48小时发货"
},
{
"code": "qtbh",
"name": "7天包换"
},
{
"code": "qtwlybt",
"name": "7天无理由包退"
},
{
"code": "shbp",
"name": "少货必赔"
}
],
"title": "2025欧美跨境女装亚马逊独立站春夏新款刺绣圆领泡泡短袖衬衫上衣",
"skuCnt": 25
},
{
"imgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01ky5shO1e072lyZeTd_!!1741453808.jpg",
"itemId": 895110619077,
"maxPrice": 1700,
"minPrice": 1700,
"serviceList": [
{
"code": "ssbxsfh",
"name": "48小时发货"
},
{
"code": "qtbh",
"name": "7天包换"
},
{
"code": "qtwlybt",
"name": "7天无理由包退"
},
{
"code": "czbz",
"name": "材质保障(限地区)"
},
{
"code": "psbj",
"name": "破损包赔"
},
{
"code": "shbp",
"name": "少货必赔"
},
{
"code": "hdbp",
"name": "坏单包赔"
}
],
"title": "春秋格子衬衫女宽松慵懒风女装上衣2025早秋新款衬衣复古格纹外套",
"skuCnt": 6
}
],
"pageInfo": {
"currentPage": 1,
"totalRecords": 2000,
"pageSize": 20
}
},
"trace_id": ""
}
3. 返回字段说明
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
imgUrl | String | 图片链接 | http://ali.cdn.ss/adfs/23434565.png |
itemId | Long | 商品id | 323222 |
maxPrice | Long | 最大价格(分) | 5900 |
minPrice | Long | 最小价格(分) | 5900 |
salesCnt90d | Long | 90天销量 | 1100 |
title | String | 商品标题 | 帽子防晒帽快干太阳帽儿童亲子遮阳帽 |
skuCnt | Long | sku数量 | 3 |
serviceList | 对象集合 | ||
— code | String | 买家服务保障名称码 | qtwlybt |
— name | String | 买家服务保障名称 | |
pageInfo | 分页对象 | ||
— currentPage | Integer | 当前页码 | 1 |
— totalRecords | Integer | 总的记录数 | 2000 |
— pageSize | Integer | 分页大小 | 20 |
说明: code为0表示成功,非0为失败,message会包含失败原因。 业务上是否成功,以data内的success为准 。
文档更新时间: 2025-08-08 16:57 作者:admin