电商平台商品类目列表

获取电商平台的商品类目列表

一、接口名称

• 接口名称：电商平台商品类目列表
• 接口地址：https://kf.fw199.com/gateway/eop/cats/list
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

按电商平台标识 op 与父类目 parent_cid 查询直接子类目列表的记录。可选传入 name 对类目名称做模糊匹配。

典型用法：

1. 首次传 parent_cid=0 获取一级类目
2. 用户选中某类目后，以其 cid 作为下一次请求的 parent_cid，逐级下钻
3. 需要搜索时，在指定父类目下附加 name 关键词

二、请求参数

公共参数

业务参数

op 平台标识（常用）

三、请求示例代码（Java）

示例一：查询抖店一级类目

@Test
public void eopCatsListRoot() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/eop/cats/list";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("op", "3");
    data.put("parent_cid", "0");
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

示例二：查询指定父类目下的子类目

@Test
public void eopCatsListChildren() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/eop/cats/list";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("op", "3");
    data.put("parent_cid", "1000000957"); // 上一级类目的 cid
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

示例三：在父类目下按名称模糊搜索

@Test
public void eopCatsListByName() throws Exception {

    String apiUrl = "https://kf.fw199.com/gateway/eop/cats/list";

    Map<String, String> data = new HashMap<>();
    data.put("appid", Config.AppId);
    data.put("timestamp", String.valueOf(System.currentTimeMillis() / 1000));
    data.put("op", "8");
    data.put("parent_cid", "0");
     data.put("name", "鞋");
    data.put("sign", Utils.Sign(data, Config.AppSecret));

    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

说明：

• 最外层 code 为 0 表示成功，非 0 为失败，message 包含失败原因
• 成功时 data 为数组；无匹配记录时返回空数组 []
• 鉴权失败、权限未开通、签名错误等场景不返回业务 data

4.1 成功示例

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "cid": 1000000957,
      "is_parent": 1,
      "name": "鞋靴",
      "parent_cid": 0,
      "cats_level": 1,
      "full_ids": "1000000957",
      "full_name": "鞋靴"
    },
    {
      "cid": 1000001648,
      "is_parent": 1,
      "name": "办公用品",
      "parent_cid": 0,
      "cats_level": 1,
      "full_ids": "1000001648",
      "full_name": "办公用品"
    }
  ],
  "trace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

4.2 data 数组元素字段说明

4.3 失败示例

参数缺失：

{
  "code": 1,
  "message": "参数parent_cid不能为空"
}

签名失败：

{
  "code": 105,
  "message": "签名失败"
}

权限未开通：

{
  "code": 104,
  "message": "您没有开通此接口的权限，请联系客服"
}

余额不足 / 扣费失败：

{
  "code": 20,
  "message": "扣减费用失败，请联系客服"
}

五、常见错误码