查询商品分类

API文档最后更新: 2026-08-31

6.1 查询商品分类

请求方式：GET
请求地址：/categories

请求字段：无。

返回字段：

字段	JSON 类型	必填	含义
`code`	integer	是	固定为 `0`，表示请求成功
`message`	string	是	本次请求的处理说明
`data`	object	是	分类查询结果
`data.list`	object[]	是	当前账户可见的商品分类数组
`data.list[].catalogRef`	integer	是	分类编号
`data.list[].parentCatalogRef`	integer 或 null	是	上级分类编号；顶级分类为 `null`
`data.list[].title`	string	是	分类名称
`data.list[].imageUrl`	string 或 null	是	分类图片公网地址；没有图片时为 `null`
`data.list[].displayOrder`	integer	是	显示顺序，数值越小越靠前
`data.list[].revision`	integer	是	分类最后更新时间，10 位 Unix 秒级时间戳
`data.list[].updatedAt`	integer	是	分类最后更新时间，10 位 Unix 秒级时间戳
`requestId`	string	是	本次请求编号，排查问题时提供给平台

只返回平台当前显示并且包含授权商品的分类。平台隐藏的分类不会返回：

{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "catalogRef": 10,
        "parentCatalogRef": null,
        "title": "话费充值",
        "imageUrl": "https://cdn.example.com/categories/recharge.png",
        "displayOrder": 10,
        "revision": 1785215000,
        "updatedAt": 1785215000
      }
    ]
  },
  "requestId": "req_01K0EXAMPLE"
}