按分组 slug 获取单个导航分组(含该组下所有菜单卡片)。
获取单个导航分组
GET /api/open/nav/groups/:slug
该接口按分组 slug 获取 单个导航分组,结构与 GET /api/open/nav/groups 返回的 groups[] 单项一致。
适用于已知 slug(如 web3-tools)时只拉取该分组,无需拉取全量分组列表。
请求地址
GET /api/open/nav/groups/:slug
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
slug | string | 与后台 NavGroup 注册一致,如 web3-tools |
查询参数
| 参数 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
locale | string | 否 | 分组名称、描述及 navs 文案语言 |
返回体
200 OK,application/json,单条 NavGroup:
| 字段 | 类型 | 说明 |
|---|---|---|
key | string | 分组 key |
slug | string | 分组 slug |
name | string | 分组名称 |
description | string | undefined | 分组描述 |
navs | object[] | 该分组下的菜单卡片(title、description、href) |
错误码
| HTTP 状态 | 场景 |
|---|---|
404 | 无此 slug,响应体含 error: Nav group not found |
429 | 命中 open API 限流 |
500 | 服务器内部错误 |
请求示例
curl -s "https://www.web3base.ai/api/open/nav/groups/web3-tools?locale=zh-hans" | jq返回示例
{
"key": "web3-tools",
"slug": "web3-tools",
"name": "Web3 工具",
"description": "链上工具与导航",
"navs": [
{
"title": "Web3 核心工具",
"description": "钱包、多链、Solana 等",
"href": "/nav/web3-core-tools"
}
]
}