**版本：202601**

# 查询菜单导航列表

**GET** `/openapi/2026-01/menus`

返回店铺的菜单（导航）列表，支持按 ids 过滤、隐藏禁用项。

## 请求

**Query参数**

- `ids` string[]

  可选，按菜单 id 过滤；不传 = 全部菜单
- `hide_disabled` boolean

  为 true 时隐藏禁用的菜单项
- `page` int32

  页码
- `page_size` int32

  每页条数，默认 100

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `menus` object[]

    菜单列表；每个菜单：`{id, title, category, children:[...]}`
  - `total` int32

    菜单总数
  - `page` int32

    当前页码
  - `limit` int32

    每页条数
  - `has_more` boolean

    是否还有下一页

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "menus": [
      {}
    ],
    "total": 0,
    "page": 0,
    "limit": 0,
    "has_more": true
  }
}
```