按模块返回筛选维度分组(链 / Twitter / YouTube),含稳定 key 与多语言标签。
获取分类维度分组
GET /api/open/category-groups
该接口按 业务模块 返回筛选维度分组(如链的「链层级 / 生态」,Twitter 的「账号类型 / 认证」)。
通常配合 GET /api/open/categories 使用,用于:
- 构建侧栏筛选器(每个分组对应一个折叠块)
- 在客户端把分类项按
groupKey做二级分组展示
请求地址
GET /api/open/category-groups
请求参数
| 参数 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
module | string | 是 | 业务模块:chain、twitter 或 youtube |
建议:页面初始化时为每个模块各拉一次,结果可做本地缓存。
返回体
200 OK,application/json:
| 字段 | 类型 | 说明 |
|---|---|---|
module | string | 与请求参数一致 |
groups | object[] | 维度分组列表,已按 priority 升序排好 |
其中 groups 的单项结构(CategoryGroupDimension):
| 字段 | 类型 | 说明 |
|---|---|---|
key | string | 维度 key,稳定、不随语言改变,例如 ecosystem、chain_layer |
i18n | object | 各语言名称,如 { "en": "Ecosystem", "zh-hans": "生态" } |
priority | number | 排序权重,数值越小越靠前 |
错误码
| HTTP 状态 | 场景 |
|---|---|
400 | 缺少或非法 module |
429 | 命中 open API 限流(60/300 次每分钟) |
500 | 服务器内部错误 |
请求示例
curl -s "https://www.web3base.ai/api/open/category-groups?module=chain" | jq
curl -s "https://www.web3base.ai/api/open/category-groups?module=twitter" | jq返回示例
{
"module": "chain",
"groups": [
{
"key": "ecosystem",
"i18n": {
"en": "Ecosystem",
"zh-hans": "生态",
"zh-hant": "生態系"
},
"priority": 1
}
]
}前端可根据
key决定图标/排版,根据i18n[locale]渲染当前语言标题。