查询商品分类列表

GET 
/openapi/2026-07/categories

返回店铺中所有商品分类的列表。

请求

Query参数

pid uint64

上级分类 ID；用于查询该分类下的子分类

ids uint64[]

待查询的分类 ID 列表。 示例：?ids=1001&ids=1002

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
categories object[]
分类列表
Array [
iduint64
分类 ID
namestring
分类名称
piduint64
上级分类 ID
levelint32
分类层级（如 1 表示一级分类）
positionint32
分类在同级中的排序位置
pathstring
分类层级路径（从根分类到当前分类，例如 服饰/上衣/T恤）
google_idint32
关联的 Google 分类 ID
]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "categories": [
      {
        "id": 0,
        "name": "string",
        "pid": 0,
        "level": 0,
        "position": 0,
        "path": "string",
        "google_id": 0
      }
    ]
  }
}