商品关键词搜索接口

商品关键词搜索接口

实现商品图搜，返回相关商品信息。 offerId经过加密处理后为openOfferId。对于搜索出来的商品，可以通过调用获取商品详情获取商品详情信息。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/1688/product/keyword/offer/search

基础参数

request业务参数

request_data的示例报文

{
  "filter" : [ "shipIn48Hours" ],
  "keywords" : "女士鞋子",
  "pageSize" : 10,
  "pageNum" : 1
}

2. 请求示例代码(Java)

    @Test
    public void AlibabaProductKeywordSearchRequest() 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("jxhy");
//        filters.add("shipIn48Hours");
//        requestData.put("filter", filters);
        requestData.put("keywords", "女士鞋子");
        requestData.put("pageNum", 1);
        requestData.put("pageSize", 1);
        data.put("request_data", requestData.toJSONString());
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        // 调用服务API
        String response = doHttpRequest(Config.AlibabaProductKeywordSearchRequest, data);
    }

3. 返回结果如下：

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "success": true,
      "code": null,
      "message": null,
      "result": [
        {
          "openOfferId": "WUiP45gahkpKl8e4EpfN3g==",
          "subject": "新款经典同款小白鞋女爆款百搭松糕厚底增高女鞋休闲新款透气板鞋",
          "offerId": null,
          "loginId": null,
          "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": null
          },
          "offerImage": {
            "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01C7rFB72CwSQwdOcEC_!!2209445208538-0-cib.jpg"
          },
          "offerPrice": {
            "consignPrice": "19.00",
            "priceUnderLine": "22.00",
            "price": "22.00",
            "quantityPrice": null
          },
          "offerTradeServiceInfo": [],
          "offerHistoryTradeInfo": null,
          "qualityEvaluation": {
            "compositeScore": 3.5,
            "consultationScore": 3,
            "disputeScore": 4,
            "logisticsScore": 3.5,
            "goodsScore": 3,
            "returnScore": 3.5
          }
        }
      ],
      "pageInfo": {
        "totalPage": 2001,
        "currentPage": 1,
        "pageSize": 1,
        "totalRecords": 2000
      }
    }
  },
  "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值，返回字段说明见文档