模块说明
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 分钟)。