加载中…
首页聚合 index

模块说明

index 一次返回首页所需的聚合数据:首页展示模块(show_list)、推荐商品、推荐文章、商品分类树与站点"关于"信息。适合客户端首屏一个请求完成渲染。

鉴权级别:可选(匿名可调;登录后部分数据可能带个性化字段,以实际返回为准)。

接口一览

方法 URL 鉴权 说明
GET /api/index 可选 首页聚合数据

请求

无参数。

GET /api/index

响应

{
  "code": "OK",
  "message": "",
  "data": {
    "show_list": [ { "name": "...", "type": "...", "...": "首页展示模块配置与数据" } ],
    "recommend_product": [ { "id": 1, "name": "...", "price": "99.00", "thumb": "...", "...": "" } ],
    "recommend_article": [ { "id": 1, "title": "...", "thumb": "...", "...": "" } ],
    "product_category": [ { "id": 1, "name": "...", "children": [] } ],
    "about": { "...": "关于信息(后台单页数据)" }
  },
  "errors": {},
  "request_id": "9f2a5c8e1b3d7f40"
}
字段 说明
show_list 首页展示模块列表(与后台"首页展示"配置联动),按配置顺序渲染
recommend_product 推荐商品(最多 8 条,sort DESC)
recommend_article 推荐文章(最多 8 条,sort DESC)
product_category 商品分类树(含子级)
about 站点"关于"信息

注意事项

  • show_list 的结构随后台展示模块类型而变,客户端应按 type 分支渲染,未知类型直接跳过以保证向后兼容;
  • 推荐列表数量上限为 8,如需更多请调对应模块列表接口;
  • 本接口数据变化频率中等,可做短时缓存(如 1~5 分钟)。
添加日期:2026-10-06