国内分销词搜
国内分销词搜选品,对于搜索出来的商品,可以通过调用获取商品详情获取商品详情信息。
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/1688/fenxiao/keywords/offer/search
基础参数
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | 32432143214214 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
seller_nick | String | true | b2b-1624961122 | 1688账号 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
request_data | Json | true | 查询条件的业务报文 |
request业务参数
名称 | 类型 | 是否必须 | 描述 | 示例值 |
---|---|---|---|---|
categoryIds | java.lang.String[] | 否 | 限定类目ID列表,从类目搜索接口获取 | [“10166”] |
filter | java.lang.String[] | 否 | 选品中心小二的严选优质品:454658 线下选品中心陈列品:454466 | [“454658”, “454466”] |
keywords | java.lang.String | 否 | 搜索关键词 | 衣服 |
pageNum | java.lang.Long | 否 | 当前页码 | 1 |
pageSize | java.lang.Long | 否 | 分页页大小,默认20最大50 | 20 |
priceEnd | java.lang.String | 否 | 价格区间结束(单位 元) | 1 |
priceStart | java.lang.String | 否 | 价格区间开始(单位 元) | 5 |
quantityBegin | java.lang.Long | 否 | 起批量 | 1 |
request_data的示例报文
{
"filter" : [ "454466" ],
"keywords" : "鞋子",
"pageSize" : 10,
"pageNum" : 1
}
2. 请求示例代码(Java)
@Test
public void AlibabaOceanOpenplatformBizSearchParamOpenKeywordsSearchRequest() 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());
JSONObject requestData = new JSONObject();
// JSONArray filters = new JSONArray();
// filters.add("454466");
// requestData.put("filter", filters);
requestData.put("keywords", "鞋子");
requestData.put("pageNum", 1);
requestData.put("pageSize", 10);
data.put("request_data", requestData.toJSONString());
data.put("sign", Utils.Sign(data, Config.AppSecret));
String response = doHttpRequest(Config.One688FenXiaocKeyWordsOfferSearchRequest, data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"result": {
"success": true,
"code": null,
"message": null,
"result": [
{
"openOfferId": null,
"subject": "多层抽屉式收纳柜大容量文胸袜子衣服置物柜卧室床头杂物储物柜子",
"offerId": 805683431540,
"loginId": "台州日百供应链",
"unit": null,
"quantityBegin": null,
"offerWeight": null,
"offerSuttleWeight": null,
"isJxhy": null,
"userId": null,
"companyInfo": {
"companyName": "台州日百供应链管理有限公司",
"city": "台州市",
"province": "浙江",
"creditLevel": null,
"isFactory": null,
"shopRepurchaseRate": null,
"shopRepurchaseRateLevel": null,
"url": "https://m.1688.com/winport/b2b-22176143595548a83e.html?__existtitle__=1"
},
"offerImage": {
"imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01XKyLNF2KRmybOQKSm_!!2217614359554-0-cib.jpg"
},
"offerPrice": {
"consignPrice": "63.70",
"priceUnderLine": "109.0",
"price": "109.0",
"quantityPrice": null
},
"offerTradeServiceInfo": [],
"offerHistoryTradeInfo": null,
"qualityEvaluation": {
"compositeScore": 4.0,
"consultationScore": 3.0,
"disputeScore": 4.0,
"logisticsScore": 3.0,
"goodsScore": 3.0,
"returnScore": 3.0
}
}
],
"pageInfo": {
"totalPage": 50,
"currentPage": 1,
"pageSize": 1,
"totalRecords": 50
}
}
},
"trace_id": ""
}
为空的情况
{
"code": 0,
"message": "ok",
"data": {
"result": {
"success": false,
"code": "SEARCH_ERROR",
"message": null,
"result": null,
"pageInfo": null
}
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。业务上成功与否,见data中success值,返回字段说明见文档
文档更新时间: 2025-07-01 18:03 作者:admin