跳到主要内容

getSortList

通用商品分类列表（轻量，不含商品数据 goodList）。供前台分类导航等「只要分类元数据」的场景直接读取，不依赖 getProduct 的商品聚合。

:::tip 与 getProduct 的区别 getProduct 从商品聚合派生分类，店内 0 商品时返回空。getSortList 直接查分类表 erp_goods_sort，与是否有商品无关，且响应轻量（不 preload goodList）。 :::

属性值
方法GET
路径/config/getSortList
鉴权公开

请求参数​

均为可选，缺省不筛该项。

参数类型必填默认说明
languagestring否全部语言语言码（如 en）。空 = 返回全部语言的分类行
enabledstring否全部1/true = 仅启用；0/false = 仅停用；不传 = 启用与停用都返回
keystring否全部逗号分隔的分类 key 白名单（如 earrings,necklaces）；不传 = 全部分类

响应​

data.list 为分类数组，按 weight 降序。每项为一个分类行（同一分类的不同语言是不同的行，用 language 区分）。

{
  "code": 0,
  "message": "",
  "data": {
    "list": [
      {
        "id": 1,
        "key": "earrings",
        "image_src": "https://asset.boldradiant.com/public/category/earrings/cover.jpg",
        "video_src": "",
        "video_cover": "",
        "name": "Earrings",
        "description": "",
        "enabled": true,
        "weight": 100,
        "language": "en",
        "created_time": "2026-08-31T00:00:00Z",
        "updated_time": "2026-08-31T00:00:00Z"
      }
    ]
  }
}
字段类型说明
idnumber分类行主键
keystring分类 key（同一分类跨语言共享）
image_srcstring分类图 URL，空串表示未配图
video_src / video_coverstring分类视频及其封面 URL
namestring分类展示名（按 language 本地化）
descriptionstring分类描述
enabledbool是否启用
weightnumber排序权重，降序
languagestring语言码
created_time / updated_timestring时间戳

示例​

# 前台首页常用:某语言下仅启用的分类
curl -s 'https://service.boldsaasify.com/config/getSortList?enabled=1&language=en' \
  -H 'X-Site-Domain: boldradiant.com'

# 指定若干分类 key
curl -s 'https://service.boldsaasify.com/config/getSortList?key=earrings,necklaces' \
  -H 'X-Site-Domain: boldradiant.com'