获取导航分组列表

GET /api/open/nav/groups

该接口返回当前启用的 导航分组 及每组下的 菜单入口卡片（标题、描述、站内 href），对应站内 /nav-group 类页面。

通常先调用本接口拿到分组与 navs[].href，再按需调用 GET /api/open/nav/menus/:pathSlug 获取单条菜单的完整树结构。

请求地址

GET /api/open/nav/groups

请求参数

参数	类型	是否必传	说明
`locale`	string	否	卡片标题与描述语言（如 `en`、`zh-hans`）

返回体

200 OK，application/json：

字段	类型	说明
`groups`	object[]	导航分组列表，每项为 `NavGroup`
`totalGroups`	number	分组总数
`totalMenus`	number	菜单（nav）总数

NavGroup 结构

字段	类型	说明
`key`	string	分组 key
`slug`	string	分组 slug，用于 GET /api/open/nav/groups/:slug
`name`	string	分组名称（已按 locale 解析）
`description`	string \| undefined	分组描述
`navs`	object[]	该分组下的菜单卡片列表

navs[] 单项

字段	类型	说明
`title`	string	菜单标题
`description`	string \| undefined	菜单描述
`href`	string	站内路径，如 `/nav/web3-core-tools`；`pathSlug` 为 `href` 中 `/nav/` 后的段

错误码

HTTP 状态	场景
`429`	命中 open API 限流
`500`	服务器内部错误

请求示例

curl -s "https://www.web3base.ai/api/open/nav/groups?locale=zh-hans" | jq

返回示例

{
  "groups": [
    {
      "key": "web3-tools",
      "slug": "web3-tools",
      "name": "Web3 工具",
      "description": "链上工具与导航",
      "navs": [
        {
          "title": "Web3 核心工具",
          "description": "钱包、多链、Solana 等",
          "href": "/nav/web3-core-tools"
        }
      ]
    }
  ],
  "totalGroups": 1,
  "totalMenus": 1
}

← 返回 API 总览