web3baseweb3base

按模块返回筛选维度分组(链 / Twitter / YouTube),含稳定 key 与多语言标签。

获取分类维度分组

GET /api/open/category-groups

该接口按 业务模块 返回筛选维度分组(如链的「链层级 / 生态」,Twitter 的「账号类型 / 认证」)。

通常配合 GET /api/open/categories 使用,用于:

  • 构建侧栏筛选器(每个分组对应一个折叠块)
  • 在客户端把分类项按 groupKey 做二级分组展示

请求地址

GET /api/open/category-groups

请求参数

参数类型是否必传说明
modulestring业务模块:chaintwitteryoutube

建议:页面初始化时为每个模块各拉一次,结果可做本地缓存。

返回体

200 OKapplication/json

字段类型说明
modulestring与请求参数一致
groupsobject[]维度分组列表,已按 priority 升序排好

其中 groups 的单项结构(CategoryGroupDimension):

字段类型说明
keystring维度 key,稳定、不随语言改变,例如 ecosystemchain_layer
i18nobject各语言名称,如 { "en": "Ecosystem", "zh-hans": "生态" }
prioritynumber排序权重,数值越小越靠前

错误码

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] 渲染当前语言标题。

← 返回 API 总览