简体中文

English

简体中文

English

显示模式

关于 类目 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

类目搜索是 Genstore 商品分类体系中的核心搜索功能，通过高效的 RESTful 接口提供类目的快速检索能力。该功能旨在优化用户的类目查找体验，提升商品发现效率，帮助商家构建更好的商品分类导航系统。

核心功能

支持通过类目名称、描述等属性进行灵活搜索，帮助用户快速定位目标类目。

应用场景

  • 类目导航优化：电商运营人员可通过接口组织商品层级、自定义分类关联关系、优化搜索参数，帮助顾客快速找到相关商品，提升发现效率。
  • 智能商品推荐：营销团队可利用分类数据配置相关商品推荐、实施跨品类促销，打造个性化商品发现流程，提升用户参与度和转化率。

接口

GET /api/202412/category/search: 产品类目搜索

产品类目 对象 ​

产品类目业务域对象。

属性 ​

productCategoryobject
产品类目。
- 收起属性
categoryIdnumber
产品类目唯一标识符。
categoryNamestring
产品类目名称。
parentCategoryIdnumber
父产品类目唯一标识符。
bash
{
  "productCategory": {
    "parentCategoryId": "209148956144",
    "categoryName": "pet",
    "categoryId": "209148956145"
  }
}

GET 产品类目搜索 ​

获取产品类目列表

访问范围

需要以下任意访问权限: write_products read_products

接口

GET /api/202412/category/search 

请求参数

sinceIdstring
起始资源 ID，主要用于首页中从 sinceId 开始查询分页。
pageTokenstring
代表某一分页的游标，默认情况下返回首页数据。
limitnumber
分页数量限制，默认限制 50。
categoryNamestring
产品类目名称。
parentCategoryIdnumber
父产品类目唯一标识符。

响应数据

productCategoriesarray
产品类目信息。
- 收起属性
categoryIdnumber
产品类目唯一标识符。
categoryNamestring
产品类目名称。
parentCategoryIdnumber
父产品类目唯一标识符。
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/category/search" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "productCategories": [
    {
      "parentCategoryId": "209148956144",
      "categoryName": "pet",
      "categoryId": "209148956145"
    }
  ]
}